Skip to main content
GET
/
api
/
tools
/
catalog
List agent tool catalog
curl --request GET \
  --url https://api.example.com/api/tools/catalog \
  --header 'Authorization: Bearer <token>'
{
  "categories": [
    {
      "key": "<string>",
      "label": "<string>",
      "description": "<string>"
    }
  ],
  "tools": [
    {
      "id": "<string>",
      "label": "<string>",
      "description": "<string>",
      "category": "<string>",
      "surface": "<string>",
      "roles": [
        "<string>"
      ],
      "risky": true,
      "default": true,
      "permitted": true
    }
  ],
  "default_tool_ids": [
    "<string>"
  ]
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Response

200 - application/json

Successful Response

The full selectable tool catalog for crew/agent configuration.

categories
ToolCategoryItem · object[]
required
tools
ToolCatalogItem · object[]
required
default_tool_ids
string[]
required

Tool ids granted to an agent that selects nothing.