Create a new tool router session

1 import requests 2 3 url = "https://backend.composio.dev/api/v3/labs/tool_router/session" 4 5 payload = { 6 "user_id": "user_123456789", 7 "config": { "toolkits": [{ 8 "toolkit": "gmail", 9 "auth_config": "auth_config_123" 10 }, { 11 "toolkit": "slack", 12 "auth_config": "auth_config_456" 13 }, { "toolkit": "github" }] } 14 } 15 headers = { 16 "x-api-key": "<apiKey>", 17 "Content-Type": "application/json" 18 } 19 20 response = requests.post(url, json=payload, headers=headers) 21 22 print(response.json())

1 { 2 "session_id": "session_123456789", 3 "chat_session_mcp_url": "https://api.composio.dev/v3/mcp/sessions/session_123456789" 4 }

Creates a new session for the tool router lab feature. This endpoint initializes a new session with specified toolkits and their authentication configurations. The session provides an isolated environment for testing and managing tool routing logic with scoped MCP server access.

Headers

x-api-keystringRequired

Request

This endpoint expects an object.

user_idstringRequired

Unique user identifier for the session owner

configobjectOptional

Session configuration including enabled toolkits and their auth configs

Response

Session successfully created. Returns the session ID and MCP server URL for the created session.

session_idstring

Generated session identifier

chat_session_mcp_urlstringformat: "uri"

MCP server endpoint URL for this specific session

Headers

Request

Response

Errors