Section ID: DOC-API-MODEL-schema-po5rioe4il#overview

ToolCallStartedEvent

Event for a tool call that has begun execution or is waiting for human approval. Check the event name and tool-call status to distinguish these cases; the event context identifies the conversation.

Meaning and usage

Section ID: DOC-API-MODEL-schema-po5rioe4il#meaning

See the definition above.

Usage profiles

Section ID: DOC-API-MODEL-schema-po5rioe4il#fields

Usage	Fields and validation
In requests	View fields
In responses	View fields

In requests

Section ID: DOC-API-MODEL-schema-po5rioe4il#request

API JSON uses JSON field names (camelCase).

Field	Type	Presence	Meaning
Section ID: DOC-API-MODEL-schema-po5rioe4il#request-field-toolcalltoolCall	ToolCall	Optional	Tool-call snapshot before a result is available, including its identity, name, server and arguments. For llm.tool_call_started the status is EXECUTING; for llm.tool_call_approval_required it is REQUIRES_CONFIRMATION and requires_approval_at is the decision deadline. result_json is unset.

In responses

Section ID: DOC-API-MODEL-schema-po5rioe4il#response

API JSON uses JSON field names (camelCase).

Field	Type	Presence	Meaning
Section ID: DOC-API-MODEL-schema-po5rioe4il#field-toolcallSection ID: DOC-API-MODEL-schema-po5rioe4il#response-field-toolcalltoolCall	ToolCall	Optional	Tool-call snapshot before a result is available, including its identity, name, server and arguments. For llm.tool_call_started the status is EXECUTING; for llm.tool_call_approval_required it is REQUIRES_CONFIRMATION and requires_approval_at is the decision deadline. result_json is unset.

Examples

Section ID: DOC-API-MODEL-schema-po5rioe4il#examples

event-llm-tool-call-started

Section ID: DOC-API-MODEL-schema-po5rioe4il#example-event-llm-tool-call-started

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

{
  "toolCall": {
    "id": "call_123",
    "name": "send_briefing",
    "serverId": "briefing-tools",
    "argumentsJson": {
      "conversation_id": "b81d5345-c1f9-4fb9-b558-a6327c75b842"
    },
    "status": "TOOL_EXECUTION_STATUS_EXECUTING"
  }
}

event-llm-tool-call-approval-required

Section ID: DOC-API-MODEL-schema-po5rioe4il#example-event-llm-tool-call-approval-required

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

{
  "toolCall": {
    "id": "call_123",
    "name": "send_briefing",
    "serverId": "briefing-tools",
    "argumentsJson": {
      "conversation_id": "b81d5345-c1f9-4fb9-b558-a6327c75b842"
    },
    "status": "TOOL_EXECUTION_STATUS_REQUIRES_CONFIRMATION",
    "requiresApprovalAt": "2026-09-16T12:05:00Z"
  }
}

Download the public reference contract.

Document ID: DOC-API-MODEL-schema-po5rioe4il