Skip to main content
WEBHOOK

Authorizations

Authorization
string
header
required

Project API key. Server-side only.

Headers

Segmnt-Signature
string
required

t=<unix seconds>,v1=<hex HMAC-SHA256>. The HMAC is over <t>.<raw body> with the endpoint's signing secret. t is the time of this delivery attempt (each retry is signed again), so refuse a t older than 5 minutes.

Example:

"t=1791648000,v1=5f2b..."

Body

application/json
id
string
required

Same for every retry of this event.

Example:

"evt_1qA7zP"

type
enum<string>
required
Available options:
video.ready,
video.failed,
video.held,
video.removed
createdAt
string<date-time>
required
projectId
string
required
data
object
required

Response

200

Return any 2xx within 10 seconds. Other answers are retried with a growing wait, up to about 8 attempts, then we mark that delivery failed. Events can arrive more than once and out of order: use id to skip duplicates, and ignore an event whose data.video.updatedAt is older than the one you have (or call GET video for the current state).