Webhook events

file.upload.failed

Delivered when a file upload fails. Only fired for files uploaded via the API.

postWebhookfile.upload.failed

Payload

event'file.upload.completed' | 'file.upload.failed' | 'file.playback_ready' | 'file.download_ready' | 'file.analysis_completed' | 'file.analysis_failed' required

Webhook event types for the file lifecycle (upload, analysis, playback, and download readiness). Only fired for files uploaded via the API (not the VideoGen UI).

fileIdstring required

File id (e.g. vg_file_...).

occurredAtinteger required

Seconds since epoch (Unix timestamp) when the event occurred.

Response

Acknowledge receipt

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.