Webhooks
Webhooks
Was this page helpful?
Receive one best-effort terminal callback when an image or video job becomes ready or fails.
Terminal payload
Set webhookUrl in the generation request. Success includes the job ID, kind, status, and output URL fields.
JSON example
{
"ok": true,
"status": "ready",
"jobId": "550e8400-e29b-41d4-a716-446655440000",
"kind": "video",
"outputUrl": "https://reviral.ai/signed-output"
}Delivery behavior
Callbacks are best effort, sent once, and not retried. A callback delivery failure does not change the job result, so polling remains the source of truth.
Receiver safety
Accept HTTPS only, return a 2xx quickly, validate the expected job ID against your own records, and fetch final state from the authenticated jobs endpoint before taking sensitive action.