> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get toolkits for a tool router session

> 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.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v3.1/tool_router/session/{session_id}/toolkits
openapi: 3.1.0
info:
  version: 3.1.0
  title: Composio Platform API v3.1
  description: >-
    Composio v3.1 API — all endpoints available under /api/v3.1/. Tool endpoints
    default to the latest tool version.
  contact:
    name: Composio Support
    url: https://composio.dev/support
    email: support@composio.dev
  license:
    name: Proprietary
    url: https://composio.dev/terms
servers:
  - url: https://backend.composio.dev
    description: Composio production API
security:
  - ApiKeyAuth: []
tags:
  - name: Authentication
    description: Authentication related endpoints
    x-group: Authentication
  - name: Auth Configs
    description: Authentication configuration management
    x-group: Auth Configs
  - name: Connected Accounts
    description: Connected account management
    x-group: Connected Accounts
  - name: Logs
    description: Logging and monitoring
    x-group: Logs
  - name: OpenAPI
    description: OpenAPI specification management
    x-group: OpenAPI
  - name: Organization
    description: Organization management
    x-group: Organization
  - name: API Keys
    description: API key management
    x-group: API Keys
  - name: Webhooks
    description: Webhook configuration
    x-group: Webhooks
  - name: Webhook Endpoints
    description: >-
      Per-OAuth-app webhook ingress endpoints. Inbound URLs the provider posts
      to, plus signing secret storage and verification.
    x-group: Webhook Endpoints
  - name: Webhook Subscriptions
    description: >-
      Webhook delivery subscriptions. Outbound URLs Composio posts trigger
      events to, plus signing secret rotation and event-type filters.
    x-group: Webhook Subscriptions
  - name: Team
    description: Team member management
    x-group: Team
  - name: Consumer Skills
    description: Organization-authored Skill management
    x-group: Consumer Skills
  - name: Toolkits
    description: Toolkit and tool management
    x-group: Toolkits
  - name: Tools
    description: Tool execution endpoints
    x-group: Tools
  - name: Triggers
    description: Trigger management and execution
    x-group: Triggers
  - name: Payments
    description: Payment and subscription management
    x-group: Payments
  - name: Billing
    description: Dashboard billing state — usage, subscription, contract (cookie-auth only)
    x-group: Billing
  - name: Compliance
    description: Organization compliance agreements and acceptance state
    x-group: Compliance
  - name: Files
    description: File management
    x-group: Files
  - name: MCP
    description: MCP server management
    x-group: MCP
  - name: MCP Partner
    description: MCP partner management
    x-group: MCP Partner
  - name: Stripe Projects
    description: Stripe Projects provisioning
    x-group: Stripe Projects
  - name: Tool Router
    description: (Labs) Tool router endpoints
    x-group: Sessions (Prev Tool Router)
  - name: Playground
    description: Dashboard playground chat
    x-group: Playground
  - name: Arena
    description: Arena conversations, messages and terms
    x-group: Arena
  - name: Projects
    description: Projects API endpoints.
    x-group: Projects
  - name: Organization Management
    description: Organization Management API endpoints.
    x-group: Organization Management
  - name: Webhook Events
    description: Events delivered by Composio to your registered webhook endpoints
    x-group: Webhook Events
paths:
  /api/v3.1/tool_router/session/{session_id}/toolkits:
    get:
      tags:
        - Tool Router
      summary: Get toolkits for a tool router session
      description: >-
        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.
      operationId: getToolRouterSessionBySessionIdToolkits
      parameters:
        - schema:
            type: string
            format: toolRouterSessionId
            description: The session ID returned when creating the session
            example: trs_1a2b3c4d5e6f
          required: true
          description: The unique identifier of the tool router session
          name: session_id
          in: path
        - schema:
            type: integer
            minimum: 1
            maximum: 50
          required: false
          description: Number of items per page, max allowed is 50
          name: limit
          in: query
        - schema:
            type: string
          required: false
          description: >-
            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.
          name: cursor
          in: query
        - schema:
            type:
              - array
              - 'null'
            items:
              type: string
            description: >-
              Filter toolkits by specific slugs (comma-separated). Overrides
              session toolkit configuration if provided.
            example: gmail,slack,github
          required: false
          description: >-
            Optional comma-separated list of toolkit slugs to filter by. If
            provided, only these toolkits will be returned, overriding the
            session configuration.
          name: toolkits
          in: query
        - schema:
            type:
              - boolean
              - 'null'
            default: false
            description: >-
              Whether to filter by connected toolkits. If provided, only
              connected toolkits will be returned.
          required: false
          description: >-
            Whether to filter by connected toolkits. If provided, only connected
            toolkits will be returned.
          name: is_connected
          in: query
        - schema:
            type: string
            description: Search query to filter toolkits by name, slug, or description
            example: gmail
          required: false
          description: Search query to filter toolkits by name, slug, or description
          name: search
          in: query
      responses:
        '200':
          description: >-
            Toolkits successfully retrieved. Returns a paginated list of
            toolkits with their metadata and connected accounts.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolRouterToolkitsListResponse'
        '400':
          description: >-
            Bad request. This may occur if pagination parameters are invalid or
            the session_id format is incorrect.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: >-
            Unauthorized. Authentication is required or the provided credentials
            are invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden. The session does not belong to the authenticated user.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: >-
            Not found. The session with the provided ID does not exist or has
            been deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: >-
            Internal server error. An unexpected error occurred while processing
            the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    ToolRouterToolkitsListResponse:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
                description: Display name of the toolkit
              slug:
                type: string
                description: Unique slug identifier
              enabled:
                type: boolean
                description: Whether the toolkit is enabled
              is_no_auth:
                type: boolean
                description: Whether the toolkit is no-auth
              composio_managed_auth_schemes:
                type: array
                items:
                  type: string
                description: Available Composio-managed auth schemes
              meta:
                type: object
                properties:
                  logo:
                    type: string
                    format: uri
                    description: URL to the toolkit logo
                  description:
                    type: string
                    description: Description of the toolkit
                  isNoAuth:
                    type: boolean
                    description: >-
                      Duplicates the top-level is_no_auth field. Kept for
                      backward compatibility with existing readers; use
                      is_no_auth instead.
                    deprecated: true
                required:
                  - logo
                  - description
                description: Toolkit metadata
              connected_account:
                type:
                  - object
                  - 'null'
                properties:
                  id:
                    type: string
                    format: connectedAccountId
                    description: Connected account identifier
                  user_id:
                    type: string
                    description: User identifier
                  status:
                    type: string
                    description: Connection status
                  created_at:
                    type: string
                    format: date-time
                    description: Creation timestamp
                  auth_config:
                    type: object
                    properties:
                      id:
                        type: string
                        description: Auth config identifier
                      auth_scheme:
                        type: string
                        description: Authentication scheme type
                      is_composio_managed:
                        type: boolean
                        description: Whether this is a Composio-managed auth config
                    required:
                      - id
                      - auth_scheme
                      - is_composio_managed
                    description: Auth config details
                required:
                  - id
                  - user_id
                  - status
                  - created_at
                  - auth_config
                description: Connected account if available
            required:
              - name
              - slug
              - enabled
              - is_no_auth
              - composio_managed_auth_schemes
              - meta
              - connected_account
        next_cursor:
          type:
            - string
            - 'null'
        total_pages:
          type: number
        current_page:
          type: number
        total_items:
          type: number
      required:
        - items
        - total_pages
        - current_page
        - total_items
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: number
            slug:
              type: string
            status:
              type: number
            request_id:
              type: string
            suggested_fix:
              type: string
            errors:
              type: array
              items:
                type: string
          required:
            - message
            - code
            - slug
            - status
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your Composio project API key. Create or copy it from the Composio
        dashboard.
      x-default: your-project-api-key

````