Tool Router
Execute a meta tool within a tool router session
Execute a Composio meta tool (COMPOSIO_*) within an existing tool router session.
post/api/v3.1/tool_router/session/{session_id}/execute_meta
Path parameters
session_idstring toolRouterSessionId
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
Tool router session ID (required for public API, optional for internal - injected by middleware)
Request body
Example request
{
"slug": "COMPOSIO_MANAGE_CONNECTIONS",
"arguments": {
"toolkits": [
"github"
],
"reinitiate_all": false
},
"experimental": {
"custom_toolkits": [
{
"slug": "ecommerce",
"name": "E-Commerce API",
"description": "Internal e-commerce API for order management and fulfillment",
"tools": [
{
"slug": "GET_CUSTOMER_ORDERS",
"name": "Get Customer Orders",
"description": "Fetch recent orders for a customer by their email address",
"input_schema": {
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Customer email"
}
},
"required": [
"email"
]
}
}
]
}
],
"custom_tools": [
{
"slug": "GET_IMPORTANT_EMAILS",
"name": "Get Important Emails",
"description": "Fetch emails marked as important from the last 24 hours",
"input_schema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Max results to return"
}
}
},
"extends_toolkit": "gmail"
}
]
}
}Response
Successfully executed the meta tool. Returns execution result, logs, and status.
Example response
{
"data": {
"message": "Hello, World!",
"status": "success"
},
"log_id": "log_abc123xyz"
}