Sign in

v63

latestOpenAPI 3.0.0Proprietaryraw.githubusercontent.com2026-08-0110571.8 MB
Tool Router

Get a tool router session by ID (v3.1)

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

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

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

Response

Session successfully retrieved. Returns the session details including configuration.

session_idstring toolRouterSessionId required

The identifier of the session

tool_router_toolsstring[] required

List of available tools in this session

config_versioninteger required

Monotonic version of the config. Incremented on each PATCH. Use for optimistic concurrency control.

Example response

{
  "session_id": "trs_1a2b3c4d5e6f",
  "mcp": {
    "url": "https://app.composio.dev/tool_router/v3/trs_1a2b3c4d5e6f/mcp"
  },
  "warnings": [
    {
      "code": "PRELOAD_TOOLS_HIGH_CONTEXT_USAGE",
      "message": "Session preloads 25 tools; each preloaded tool adds to the agent context window. Consider keeping the list at or under ~20 tools."
    }
  ]
}