ToolCallCompletedEvent
Event emitted when a tool call reaches COMPLETED, FAILED, CANCELLED or TIMED_OUT, including calls that required human approval.
Usage profiles
| Usage | Fields and validation |
|---|---|
| In webhook payloads | View fields |
In webhook payloads
Webhook JSON uses protobuf field names (snake_case).
| Field | Type | Presence | Meaning |
|---|---|---|---|
event_context | EventContext | Optional | Event provenance and routing metadata associated with the emitted event. |
tool_call | ToolCall | Optional | Final tool call: status is terminal (SUCCESS|FAILED|CANCELLED|TIMED_OUT), result_json populated. |
execution_time_ms | integer (int32) | Optional | Wall-clock execution time in milliseconds (0 when unknown, e.g. dispatch error). Minimum: -2147483648. Maximum: 2147483647. |
Where used
| Reference | Relationship |
|---|---|
| llm.tool_call_completed | Webhook JSON uses protobuf field names (snake_case). |
Download the public reference contract.
Document: DOC-API-MODEL-tool-call-completed-event.