{
"id": "evt_1qA7zP",
"createdAt": "2023-11-07T05:31:56Z",
"projectId": "<string>",
"data": {
"video": {
"id": "vid_9xR4tL",
"projectId": "<string>",
"title": "Lesson 1 - Introduction",
"durationSeconds": 123,
"qualities": [],
"sizeBytes": 123,
"failure": {
"code": "unsupported_codec",
"message": "<string>"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"readyAt": "2023-11-07T05:31:56Z"
}
}
}Webhooks
Encoding failed
data.video.failure says why.
WEBHOOK
video.failed
{
"id": "evt_1qA7zP",
"createdAt": "2023-11-07T05:31:56Z",
"projectId": "<string>",
"data": {
"video": {
"id": "vid_9xR4tL",
"projectId": "<string>",
"title": "Lesson 1 - Introduction",
"durationSeconds": 123,
"qualities": [],
"sizeBytes": 123,
"failure": {
"code": "unsupported_codec",
"message": "<string>"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"readyAt": "2023-11-07T05:31:56Z"
}
}
}Authorizations
apiKeysession
Project API key. Server-side only.
Headers
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
Response
200
Return any 2xx within 10 seconds. Other answers are retried with backoff
for up to 24 hours. 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).