Webhook eventsWebhook Events

tool_execution.failed

Delivered when a tool execution fails.

Payload

The payload of this webhook request is an object.
eventenumRequired
Webhook event types for tool execution lifecycle.
Allowed values:
toolExecutionIdstringRequired
Execution id matching the original request.
occurredAtdoubleRequired

Seconds since epoch (Unix timestamp) when the execution reached a terminal state.

toolTypestringRequired

Tool name (e.g. GENERATE_IMAGE, TEXT_TO_SPEECH).

resultslist of objectsOptional

One entry per generated result, each with a hydrated file. Present only on tool_execution.succeeded.

errorobject or nullOptional

Present only on tool_execution.failed.

Response

200
Acknowledge receipt