Webhook events

file.analysis_completed

Delivered when file analysis (description, transcript, embedding) completes. Only fired for files uploaded via the API.

postWebhookfile.analysis_completed

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.