Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.box.com/llms.txt

Use this file to discover all available pages before exploring further.

Box AI Studio is available only for Enterprise Advanced accounts.
The PUT /2.0/ai_agents/{id} endpoint updates a custom AI agent’s name, state, capabilities, or access controls.

Before you start

Make sure you have completed the steps in to create a platform app and generate a developer token.

Send a request

curl -i -X PUT "https://api.box.com/2.0/ai_agents/1234567890" \
     -H "authorization: Bearer <ACCESS_TOKEN>"

Parameters

To make a call, you must pass the following parameters. Mandatory parameters are in bold.
ParameterDescriptionExample
typeThe type of agent used to handle queries.````
nameThe name of the AI Agent.My AI Agent
access_stateThe state of the AI Agent. Value is one of enabled disabled.enabled
icon_referenceThe icon reference of the AI Agent. It should have format of the URL https://cdn01.boxcdn.net/app-assets/aistudio/avatars/<file_name>, where possible values of file_name are: logo_boxAi.png,logo_stamp.png,logo_legal.png,logo_finance.png,logo_config.png,logo_handshake.png,logo_analytics.png,logo_classification.pnghttps://cdn01.boxcdn.net/app-assets/aistudio/avatars/logo_analytics.svg
allowed_entitiesList of allowed users or groups.
askThe AI Agent to be used for ask.ask
extractThe AI Agent to be used for extraction.
text_genThe AI agent used for generating text.