API ReferenceTool Router

Get toolkits for a tool router session

Markdown
GET
/api/v3/tool_router/session/{session_id}/toolkits

Retrieves a cursor-paginated list of toolkits available in the tool router session. Includes toolkit metadata, composio-managed auth schemes, and connected accounts if available. Optionally filter by specific toolkit slugs.

Authorization

ApiKeyAuth
x-api-key<token>

API key authentication

In: header

Path Parameters

session_id*string

The unique identifier of the tool router session

FormattoolRouterSessionId

Query Parameters

limit?number|null

Number of items per page, max allowed is 1000

cursor?string

Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the page number and the limit is the number of items per page. The cursor is used to paginate through the items. The cursor is not required for the first page.

toolkits?|null

Optional comma-separated list of toolkit slugs to filter by. If provided, only these toolkits will be returned, overriding the session configuration.

is_connected?boolean|null

Whether to filter by connected toolkits. If provided, only connected toolkits will be returned.

Defaultfalse
search?string

Search query to filter toolkits by name, slug, or description

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://backend.composio.dev/api/v3/tool_router/session/trs_123456789/toolkits"
{
  "items": [
    {
      "name": "string",
      "slug": "string",
      "enabled": true,
      "is_no_auth": true,
      "composio_managed_auth_schemes": [
        "string"
      ],
      "meta": {
        "logo": "http://example.com",
        "description": "string"
      },
      "connected_account": {
        "id": "string",
        "user_id": "string",
        "status": "string",
        "created_at": "2019-08-24T14:15:22Z",
        "auth_config": {
          "id": "string",
          "auth_scheme": "string",
          "is_composio_managed": true
        }
      }
    }
  ],
  "next_cursor": "string",
  "total_pages": 0,
  "current_page": 0,
  "total_items": 0
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}