Webhook events

file.analysis_completed

Delivered when file analysis (display name, description, transcript, embedding) completes. Only fired for files uploaded via the API. The file's display name may be replaced with a short name based on the content and the original filename.

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.