List agents

List all AI agents in your enterprise using the Box AI Studio API.

Box AI Studio is available only for Enterprise Advanced accounts.

The GET /2.0/ai_agents endpoint lists all AI agents in your enterprise, with optional filters for mode, state, and fields.

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

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

await client.aiStudio.getAiAgents();

client.ai_studio.get_ai_agents()

await client.AiStudio.GetAiAgentsAsync();

try await client.aiStudio.getAiAgents()

client.getAiStudio().getAiAgents()

Parameters

To make a call, you can pass the following parameters.

Parameter	Description	Example
mode	The mode to filter the agent configuration to return. Possible values are: ask, text_gen, and extract.	ask
fields	The fields to return in the response. Value is one of ask, text_gen, extract.	ask
agent_state	The state of the agent to return. Value is one of enabled, disabled.	enabled
include_box_default	Whether to include the Box default agents in the response.	true
limit	The maximum number of items to return per page.	1000
marker	Defines the position marker at which to begin returning results.	JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii