Skip to navigation
Webhook eventsWebhook Events

tool_execution.awaiting_approval

Delivered when a generated tool result conflicts with newer project edits and needs explicit approval in the project’s Tasks drawer. The result is retained; generation has not failed and the project has not been overwritten.

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.
occurredAtintegerRequired

Seconds since epoch (Unix timestamp) when this outcome occurred.

toolTypestringRequired

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

resultslist of objectsOptional

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

errorobject or nullOptional

Present only on tool_execution.failed.

Response

200
Acknowledge receipt