Webhook events

file.download_ready

Delivered when a file is ready for download. Only fired for files uploaded via the API.

postWebhookfile.download_ready

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.