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_idstring

The unique identifier of the tool router session

Format: toolRouterSessionId

Query Parameters

limitnullable number

Number of items per page, max allowed is 1000

cursorstring

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.

toolkitsnullable array

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

is_connectednullable boolean

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

Default: false
searchstring

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"
    ]
  }
}