Skip to main content
Box AI Studio is available only for Enterprise Advanced accounts.
The AI Studio API provides full CRUD operations for managing custom AI agents. Each agent can be configured with specific capabilities (ask, text_gen, extract), access controls, and custom instructions.

Create an agent

POST /2.0/ai_agents: define a new agent with capabilities, access state, and allowed entities.

List all agents

GET /2.0/ai_agents: retrieve agents filtered by mode, state, or fields.

Get agent by ID

GET /2.0/ai_agents/{id}: fetch a specific agent’s configuration.

Update an agent

PUT /2.0/ai_agents/{id}: modify an agent’s name, state, or capabilities.

Delete an agent

DELETE /2.0/ai_agents/{id}: permanently remove an agent.