Skip to main content
POST
Attach to an existing tool router session (v3.1)

Authorizations

x-api-key
string
header
default:your-project-api-key
required

Your Composio project API key. Create or copy it from the Composio dashboard.

Path Parameters

session_id
string<toolRouterSessionId>
required

The unique identifier of the tool router session

Example:

"trs_1a2b3c4d5e6f"

Body

application/json
experimental
object

Inline custom tools and toolkits for this request. v3.1 sessions do not persist customs — pass them on every request that needs them.

Response

Session successfully attached. Returns the session payload.

session_id
string<toolRouterSessionId>
required

The identifier of the session

Example:

"trs_1a2b3c4d5e6f"

mcp
object
required
tool_router_tools
string[]
required

List of available tools in this session

config
object
required

The configuration used to create this session

config_version
integer
required

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

experimental
object

Experimental v3.1 features

warnings
object[]

Advisory list — the session exists and is usable, but the listed issues may warrant attention.

Example: