---
title: "Get toolkits for a tool router session"
method: GET
path: "/api/v3.1/tool_router/session/{session_id}/toolkits"
tags: ["Tool Router"]
---

# Get toolkits for a tool router session

`GET /api/v3.1/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.

## Path parameters

- `session_id` string, toolRouterSessionId, required — The session ID returned when creating the session

## Query parameters

- `limit` integer
- `cursor` string
- `toolkits` string[], nullable — Filter toolkits by specific slugs (comma-separated). Overrides session toolkit configuration if provided.
- `is_connected` boolean, nullable — Whether to filter by connected toolkits. If provided, only connected toolkits will be returned.
- `search` string — Search query to filter toolkits by name, slug, or description

## Response `200`

Toolkits successfully retrieved. Returns a paginated list of toolkits with their metadata and connected accounts.

- ToolRouterToolkitsListResponse
  - `items` object[], required
    - `name` string, required — Display name of the toolkit
    - `slug` string, required — Unique slug identifier
    - `enabled` boolean, required — Whether the toolkit is enabled
    - `is_no_auth` boolean, required — Whether the toolkit is no-auth
    - `composio_managed_auth_schemes` string[], required — Available Composio-managed auth schemes
    - `meta` object, required — Toolkit metadata
      - `logo` string, uri, required — URL to the toolkit logo
      - `description` string, required — Description of the toolkit
    - `connected_account` object, nullable, required — Connected account if available
      - `id` string, connectedAccountId, required — Connected account identifier
      - `user_id` string, required — User identifier
      - `status` string, required — Connection status
      - `created_at` string, date-time, required — Creation timestamp
      - `auth_config` object, required — Auth config details
        - `id` string, required — Auth config identifier
        - `auth_scheme` string, required — Authentication scheme type
        - `is_composio_managed` boolean, required — Whether this is a Composio-managed auth config
  - `next_cursor` string, nullable
  - `total_pages` number, required
  - `current_page` number, required
  - `total_items` number, required

## Other responses

- `400` — Bad request. This may occur if pagination parameters are invalid or the session_id format is incorrect.
- `401` — Unauthorized. Authentication is required or the provided credentials are invalid.
- `403` — Forbidden. The session does not belong to the authenticated user.
- `404` — Not found. The session with the provided ID does not exist or has been deleted.
- `500` — Internal server error. An unexpected error occurred while processing the request.

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/versions/4239836857f8/schema)