Tool Router

Get toolkits for a tool router session

Changed on

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.

get/api/v3.1/tool_router/session/{session_id}/toolkits

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3.1/tool_router/session/{session_id}/toolkits
  • Auth
    API key in header x-api-key

Path parameters

session_idstring toolRouterSessionId required

The session ID returned when creating the session

Example:trs_1a2b3c4d5e6f

The unique identifier of the tool router session

Query parameters

limitinteger

Number of items per page, max allowed is 50

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.

toolkitsstring[] nullable

Filter toolkits by specific slugs (comma-separated). Overrides session toolkit configuration if provided.

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

is_connectedboolean nullable

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

searchstring

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

Example:gmail

Response

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

next_cursorstring nullable
total_pagesnumber required
current_pagenumber required
total_itemsnumber required

Changes

  • 98956f31abf3Revision changes
    • info

      api operation id getV3_1ToolRouterSessionBySessionIdToolkits removed and replaced with getToolRouterSessionBySessionIdToolkits

    • info

      added the optional property /// to the response with the status

  • 589a7d115a5eRevision changes
    • info

      the endpoint scheme security CookieAuth was removed from the API

    • info

      the endpoint scheme security UserApiKeyAuth was removed from the API