Execute a tool within a tool router session

Executes a specific tool within a tool router session. The toolkit is automatically inferred from the tool slug. The tool must belong to an allowed toolkit and must not be disabled in the session configuration. This endpoint validates permissions, resolves connected accounts, and executes the tool with the session context.

Authentication

x-api-keystring

API key authentication

Path parameters

session_idstringRequiredformat: "toolRouterSessionId"

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

Headers

x-session-access-keystringOptional

Request

This endpoint expects an object.

tool_slugstringRequired>=1 character

The unique slug identifier of the tool to execute

argumentsmap from strings to anyOptional

The arguments required by the tool

Response

Successfully executed the tool. Returns execution result, logs, and status.

datamap from strings to any

The data returned by the tool execution

errorstring or null

Error message if the execution failed, null otherwise

log_idstring

Unique identifier for the execution log

1	import requests
2
3	url = "https://backend.composio.dev/api/v3/tool_router/session/trs_LX9uJKBinWWr/execute"
4
5	payload = { "tool_slug": "GITHUB_CREATE_ISSUE" }
6	headers = {
7	"x-api-key": "<apiKey>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

1	{
2	"data": {
3	"message": "Hello, World!",
4	"status": "success"
5	},
6	"error": "string",
7	"log_id": "log_abc123xyz"
8	}

Authentication

Path parameters

Headers

Request

Response

Errors