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

Changes

Changed in 4 of the 61 revisions of this API.25

  • 589a7d115a5e2See the full diff
    • ○

      the endpoint scheme security CookieAuth was removed from the API

      api-security-removed

    • ○

      the endpoint scheme security UserApiKeyAuth was removed from the API

      api-security-removed

  • 6ccbbc3d49b91See the full diff
    • ▲

      the config/connected_accounts/additionalProperties/ response's property type/format changed from string/connectedAccountId to array/ for status 200

      response-property-type-changed

  • 5a3709be76a712See the full diff
    • ▲

      response property config/preload/tools list-of-types was widened by adding types string to media type application/json of response 200

      response-property-list-of-types-widened

    • ○

      added the required property config/execute to the response with the 200 status

      response-required-property-added

    • ○

      added the required property config/search to the response with the 200 status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 52c71f747c651See the full diff
    • ○

      endpoint added

      endpoint-added