~/docs/webhooks / events / tool.called

tool.called

Fired when the orchestrator AI executes a tool call.

This event provides deep visibility into the orchestrator AI's autonomous actions. Whenever the AI decides to use a registered tool (e.g., retrieving data from your systems, making API calls), this event broadcasts the exact input arguments passed to the tool.

Payload

json

{
  "event": "tool.called",
  "timestamp": "2026-06-13T17:37:50.539Z",
  "data": {
    "input": {
      "page": 1,
      "limit": 20,
      "action": "list"
    },
    "chatId": "5620d1c6-b394-405c-9608-6ade631f98f2",
    "toolName": "manage_brain",
    "messageId": "09983573-3699-4192-b8ff-4a180d16f928",
    "executedAt": "2026-06-13T17:37:50.539Z",
    "toolCallId": "call_a83b0714fa984267bb20128b"
  }
}

input

A JSON object containing the exact arguments the AI passed to the tool.

toolName

The string identifier of the tool being executed.

toolCallId

A unique identifier for this specific tool execution attempt.

All Events