A tool call (to the tool's own URL)
Not a webhook event.
webhook-id*stringThis tool call's id (tcl_…). Unique per request.
^tcl_[0-9A-Za-z]{20}$"tcl_4Zq9Hv2NcP7xMb1KrW6s"webhook-timestamp*stringUnix seconds when we sent it, as a decimal string. It is signed in.
^[0-9]+$webhook-signature*stringOne v1,<base64> signature per tool secret still signing (two during a rotation's grace), space-separated.
^v1,[A-Za-z0-9+/]+={0,2}( v1,[A-Za-z0-9+/]+={0,2})*$"v1,j3DA+jkjXWui/cEnonEAVLuZfyTYaPasc6ZdLT4x/Vk="user-agent*stringAlways acme-tools/1 (the name will change with the product's).
application/json- body
What a tool's endpoint receives when the mind calls it (compact JSON, keys in alphabetical order).
id*ToolCallIdOne use of a tool during a call.
^tcl_[0-9A-Za-z]{20}$"tcl_4Zq9Hv2NcP7xMb1KrW6s"call_id*CallIdA call's id (ours; the engine's session id is never shown).
^call_[0-9A-Za-z]{20}$"call_2Gx7Mb9KpQ4sVn1ZrT6e"character_id*CharacterIdA character's id.
^chr_[0-9A-Za-z]{20}$"chr_4fT9kQ2mXw7LbN3pZs8V"tool*stringThe tool's name.
tool_id*ToolId^tool_[0-9A-Za-z]{20}$"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.
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?unknownWhat a tool's endpoint receives when the mind calls it (compact JSON, keys in alphabetical order).
{ "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"}{ "webhook-id": "tcl_4Zq9Hv2NcP7xMb1KrW6s", "webhook-timestamp": "1793300050", "webhook-signature": "v1,EqSlmzlk/s8cb0ta4lnfKYJAYW23wF+xXz522Ep7oUs=", "user-agent": "acme-tools/1"}