Made in 10Docs
GuidesAPI
ReferenceWebhook events

A tool call (to the tool's own URL)

Not a webhook event.

Header Parameters

webhook-id*string

This tool call's id (tcl_…). Unique per request.

Match^tcl_[0-9A-Za-z]{20}$
Example"tcl_4Zq9Hv2NcP7xMb1KrW6s"
webhook-timestamp*string

Unix seconds when we sent it, as a decimal string. It is signed in.

Match^[0-9]+$
webhook-signature*string

One v1,<base64> signature per tool secret still signing (two during a rotation's grace), space-separated.

Match^v1,[A-Za-z0-9+/]+={0,2}( v1,[A-Za-z0-9+/]+={0,2})*$
Example"v1,j3DA+jkjXWui/cEnonEAVLuZfyTYaPasc6ZdLT4x/Vk="
user-agent*string

Always acme-tools/1 (the name will change with the product's).

Request Body

application/json
  1. body

What a tool's endpoint receives when the mind calls it (compact JSON, keys in alphabetical order).

id*ToolCallId

One use of a tool during a call.

Match^tcl_[0-9A-Za-z]{20}$
Example"tcl_4Zq9Hv2NcP7xMb1KrW6s"
call_id*CallId

A call's id (ours; the engine's session id is never shown).

Match^call_[0-9A-Za-z]{20}$
Example"call_2Gx7Mb9KpQ4sVn1ZrT6e"
character_id*CharacterId

A character's id.

Match^chr_[0-9A-Za-z]{20}$
Example"chr_4fT9kQ2mXw7LbN3pZs8V"
tool*string

The tool's name.

tool_id*ToolId
Match^tool_[0-9A-Za-z]{20}$
Example"tool_6Mx1Rb8QwT3kNv5LcZ9p"
arguments*

The mind's arguments, a JSON object (at most 16 KB). Not checked against the tool's parameters: check them yourself.

metadata*

The call's metadata (what startCall was sent, or a meeting's for a meeting's call), {} otherwise.

Response Body

The tool's result, within timeout_ms and at most 16 KB: JSON of any shape, plain text, or nothing ("Done." for the mind).

response?unknown
Example Requests
POST/tool.call

What a tool's endpoint receives when the mind calls it (compact JSON, keys in alphabetical order).

Request Body
application/json
{  "arguments": {    "order": "A-17"  },  "call_id": "call_2Gx7Mb9KpQ4sVn1ZrT6e",  "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V",  "id": "tcl_4Zq9Hv2NcP7xMb1KrW6s",  "metadata": {    "ticket": 7  },  "tool": "order_status",  "tool_id": "tool_6Mx1Rb8QwT3kNv5LcZ9p"}
Header Parameters
{  "webhook-id": "tcl_4Zq9Hv2NcP7xMb1KrW6s",  "webhook-timestamp": "1793300050",  "webhook-signature": "v1,EqSlmzlk/s8cb0ta4lnfKYJAYW23wF+xXz522Ep7oUs=",  "user-agent": "acme-tools/1"}