Delivered when a tool execution is cancelled.
Delivered to your webhook endpoint when a tool execution reaches a terminal state. The shape mirrors the ExecutedTool response with the addition of event and occurredAt.
Webhook event types for tool execution lifecycle.
Execution id matching the original request.
Seconds since epoch (Unix timestamp) when the execution reached a terminal state.
Tool name (e.g. GENERATE_IMAGE, TEXT_TO_SPEECH).
One entry per generated result, each with a hydrated file. Present only on tool_execution.succeeded.
Standard error body returned with every non-2xx response (the default response of every operation). The HTTP status code conveys the error class; this body carries the details:
Common code values include invalid_request, invalid_api_key, not_authorized, not_found, insufficient_credits, and rate_limited. Always branch on code (and requirement.type when present) rather than parsing message.
Acknowledge receipt