Skip to main content
GET
Get toolkits for a tool router session

Authorizations

x-api-key
string
header
default:your-project-api-key
required

Your Composio project API key. Create or copy it from the Composio dashboard.

Path Parameters

session_id
string<toolRouterSessionId>
required

The unique identifier of the tool router session The session ID returned when creating the session

Example:

"trs_1a2b3c4d5e6f"

Query Parameters

limit
integer

Number of items per page, max allowed is 50

Required range: 1 <= x <= 50
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
string[] | null

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

Example:

"gmail,slack,github"

is_connected
boolean | null
default:false

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

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.

items
object[]
required
total_pages
number
required
current_page
number
required
total_items
number
required
next_cursor
string | null