Webhook events

file.playback_ready

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

postWebhookfile.playback_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.