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.

Authentication

x-api-keystring

API key authentication

Path parameters

session_idstringRequiredformat: "toolRouterSessionId"

The unique identifier of the tool router session

Query parameters

limitdoubleOptional

Number of items per page, max allowed is 1000

cursorstringOptional

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.

toolkitslist of stringsOptional

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

Response

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

itemslist of objects

total_pagesdouble

current_pagedouble

total_itemsdouble

next_cursorstring or null

1	import requests
2
3	url = "https://backend.composio.dev/api/v3/tool_router/session/trs_123456789/toolkits"
4
5	headers = {"x-api-key": "<apiKey>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"items": [
3	{
4	"name": "string",
5	"slug": "string",
6	"enabled": true,
7	"composio_managed_auth_schemes": [
8	"string"
9	],
10	"meta": {
11	"logo": "string",
12	"description": "string"
13	},
14	"connected_account": {
15	"id": "string",
16	"user_id": "string",
17	"status": "string",
18	"created_at": "2024-01-15T09:30:00Z",
19	"auth_config": {
20	"id": "string",
21	"auth_scheme": "string",
22	"is_composio_managed": true
23	}
24	}
25	}
26	],
27	"total_pages": 1.1,
28	"current_page": 1.1,
29	"total_items": 1.1,
30	"next_cursor": "string"
31	}

Authentication

Path parameters

Query parameters

Response

Errors