Tool Router

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

Changed on

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}

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3.1/tool_router/session/{session_id}
  • Auth
    API key in header x-api-key

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."
    }
  ]
}

Changes

  • 798d44375fdcRevision changes
    • breaking

      added subschema #1 subschema #2 to the // response property oneOf list for the response status

    • info

      removed subschema #1 subschema #2 from the // response property oneOf list for the response status

  • c5fa4e0aa3eaRevision changes
    • info

      added the optional property / to the response with the status