Get a tool router session by ID

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

1 { 2 "session_id": "trs_123456789", 3 "mcp": { 4 "type": "HTTP", 5 "url": "https://app.composio.dev/tool_router/v3/trs_123456789/mcp" 6 }, 7 "tool_router_tools": [ 8 "COMPOSIO_SEARCH_TOOLS" 9 ], 10 "config": { 11 "user_id": "string", 12 "toolkits": { 13 "enabled": [ 14 "string" 15 ] 16 }, 17 "auth_configs": {}, 18 "connected_accounts": {}, 19 "connections": { 20 "auto_manage_connections": true, 21 "infer_scopes_from_tools": true, 22 "callback_uri": "string" 23 }, 24 "tools": { 25 "overrides": {}, 26 "filters": { 27 "tags": { 28 "include": [ 29 "string" 30 ], 31 "exclude": [ 32 "string" 33 ] 34 } 35 } 36 }, 37 "execution": { 38 "proxy_execution_enabled": true, 39 "timeout_seconds": 1.1 40 } 41 } 42 }

Retrieves an existing tool router session by its ID. Returns the session configuration, MCP server URL, and available tools.

Authentication

x-api-keystring

API key authentication

Path parameters

session_idstringRequiredformat: "toolRouterSessionId"

The unique identifier of the tool router session

Response

Session successfully retrieved. Returns the session details including configuration.

session_idstringformat: "toolRouterSessionId"

The identifier of the session

mcpobject

tool_router_toolslist of enums

List of available tools in this session

Allowed values:

configobject

The session configuration including user, toolkits, and overrides

Authentication

Path parameters

Response

Errors