API ReferenceSessions (prev Tool Router)

Execute a meta tool within a tool router sessionv3.0

POST
/api/v3/tool_router/session/{session_id}/execute_meta

Executes a Composio meta tool (COMPOSIO_*) within a tool router session. This endpoint is kept for meta-tool compatibility; clients can also use the primary /execute endpoint.

Authorization

ApiKeyAuth
x-api-key<token>

Project API key authentication

In: header

Path Parameters

session_idstring

Tool router session ID (required for public API, optional for internal - injected by middleware)

Format: toolRouterSessionId

Request Body

application/json

slugenumRequired

The unique slug identifier of the meta tool to execute

Possible values:
COMPOSIO_SEARCH_TOOLSCOMPOSIO_MULTI_EXECUTE_TOOLCOMPOSIO_MANAGE_CONNECTIONSCOMPOSIO_WAIT_FOR_CONNECTIONSCOMPOSIO_REMOTE_WORKBENCHCOMPOSIO_REMOTE_BASH_TOOLCOMPOSIO_GET_TOOL_SCHEMASCOMPOSIO_SUBMIT_FEEDBACKCOMPOSIO_PROXY_EXECUTE
argumentsobject

The arguments required by the meta tool

input_responsesobjectExperimental

The user's answers to an input_required response, keyed by the ids in its input_requests. Send them by repeating the same call (same tool and arguments) with this field added, along with the response's request_state if present. An approved call runs; a denied or declined one returns failed.

request_statestringExperimental

The request_state from the input_required response, sent back unchanged with input_responses.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v3/tool_router/session/{session_id}/execute_meta" \  -H "Content-Type: application/json" \  -d '{    "slug": "COMPOSIO_MANAGE_CONNECTIONS"  }'
{  "result_type": "completed",  "instant_charge": {    "amount": "string",    "currency": "USD",    "charged_by": "composio"  },  "data": {    "message": "Hello, World!",    "status": "success"  },  "error": "string",  "log_id": "log_abc123xyz"}
Edit this page on GitHub