Create, list, update, and delete custom AI agents through the Box AI Studio API.
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.