Skip to main content
POST
Execute a meta tool within a tool router session

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

Tool router session ID (required for public API, optional for internal - injected by middleware) The unique identifier of the tool router session. Required for public API endpoints, optional for internal endpoints where it is injected by middleware.

Example:

"trs_LX9uJKBinWWr"

Body

application/json
slug
enum<string>
required

The unique slug identifier of the meta tool to execute

Available options:
COMPOSIO_SEARCH_TOOLS,
COMPOSIO_MULTI_EXECUTE_TOOL,
COMPOSIO_MANAGE_CONNECTIONS,
COMPOSIO_WAIT_FOR_CONNECTIONS,
COMPOSIO_REMOTE_WORKBENCH,
COMPOSIO_REMOTE_BASH_TOOL,
COMPOSIO_GET_TOOL_SCHEMAS,
COMPOSIO_SUBMIT_FEEDBACK,
COMPOSIO_PROXY_EXECUTE
Example:

"COMPOSIO_MANAGE_CONNECTIONS"

arguments
object

The arguments required by the meta tool

Example:
input_responses
object

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.

Example:
request_state
string

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

Response

The tool call completed, failed, or needs the user's input before it can run. The result_type field says which of these happened.

result_type
enum<string>
required

The tool ran and succeeded

Available options:
completed
data
object
required

The data returned by the tool execution

Example:
error
string | null
required

Error message if the execution failed, null otherwise

log_id
string
required

Unique identifier for the execution log

Example:

"log_abc123xyz"

instant_charge
object

Returned only when the session enables instant.return_instant_charge and a charge is available. Failed individual tool calls omit it. Multi-execute returns one aggregate of reported charges from eligible successful calls, even if another call fails.

hook_results
object[]

Every session hook that applied to this call. Omitted when none applied.