Skip to main content

ToolCallCompletedEvent

Section ID: DOC-API-EVENT-u249vf7739#overview

Event emitted when a tool call reaches COMPLETED, FAILED, CANCELLED or TIMED_OUT, including calls that required human approval. Use this in a guide: Event catalog

Payload​

Section ID: DOC-API-EVENT-u249vf7739#payload

Payload fields: ToolCallCompletedEvent.

Payload examples​

Section ID: DOC-API-EVENT-u249vf7739#examples

These are illustrations of the selected payload Schema, not complete delivery envelopes. Transport metadata is supplied by the platform.

event-llm-tool-call-completed​

Section ID: DOC-API-EVENT-u249vf7739#example-event-llm-tool-call-completed

Illustrative payload, not a captured delivery. Identifiers, tool names and outcomes are examples; omitted fields depend on the event.

API JSON uses JSON field names (camelCase).

{
  "executionTimeMs": 240,
  "toolCall": {
    "id": "call_123",
    "name": "send_briefing",
    "serverId": "briefing-tools",
    "argumentsJson": {
      "conversation_id": "b81d5345-c1f9-4fb9-b558-a6327c75b842"
    },
    "status": "TOOL_EXECUTION_STATUS_COMPLETED",
    "resultJson": {
      "accepted": true
    }
  }
}

Notes​

Section ID: DOC-API-EVENT-u249vf7739#notes

In the live view, this event replaces the current tool activity view for the conversation.

Event-specific delivery guarantees, ordering, retention and lifecycle status are unspecified.

Audiences​

Section ID: DOC-API-EVENT-u249vf7739#audiences

  • Audience: Live view Current conversation client projection.

  • Audience: Tenant webhook Sent to subscribed tenant webhook endpoints.

Delivery and lifecycle​

Section ID: DOC-API-EVENT-u249vf7739#declared-intent

  • Live write intent: Replace

Live destination meaning​

Section ID: DOC-API-EVENT-u249vf7739#live-destination-meaning

Current tool activity view for the conversation.

Document ID: DOC-API-EVENT-u249vf7739