guides
Handle webhooks
Webhooks are planned alongside asynchronous jobs. This page states what will ship and what to use today.
Last updated 2026-07-10 · planned
Beta: Webhooks are not available yet. They ship together with the asynchronous job pattern when live provider rendering lands. This page exists so you can design against the plan; nothing here is callable today.
What to use today
Generation calls return synchronously with a complete structured outcome, so there is nothing to be notified about. Poll-style workflows in agents use the returned result directly.
What will ship
- Signed webhook events for job state changes (queued, rendering, complete, failed).
- Billing events (checkout completed, payment failed) once checkout is live.
- Signature verification with a per-endpoint secret, event ids for idempotent processing, and replay-safe redelivery.
Progress is tracked publicly on the build board and announced in the changelog.