Theta Video Service: Webhooks

Types of events that can be subscribed to

Video	Description
video.created	Occurs when a video is created
video.updated	Occurs when a video's metadata is updated, or when a video is retried
video.partial_finished	Occurs when a video's resolution is finished
video.finished	Occurs when all resolutions of a video are finished
video.errored	Occurs when an error occurs transcoding a video
video.deleted	Occurs when a video is deleted

Example API request made from Theta Video API to the partner backend

curl -X POST 'https://api.partnerbackend.com/webhooks/tva/recieve' \
-H 'Content-Type: application/json' \
-d '{
    "id": "wbhk_evnt_xxxxxxxxxxxxxxxxxxxxxx",
    "service_account_id": "srvacc_xxxxxxxxxxxxxxxxxxxxxxxxx",
    "object_id": "video_xxxxxxxxxxxxxxxxxxxxxxxxxx",
    "object_uri": "https://api.thetadrop.com/video/video_xxxxxxxxxxxxxxxxxxxxxxxxxx",
    "event": "video.created",
    "create_time": "2023-06-13 18:14:09.4416 +00:00",
    "update_time": "2023-06-13 18:14:09.4416 +00:00"
}'

📘
Use the Theta Video API to fetch the object. A URI to the object is added to the event for convenience.

🚧
Delivery of events is not guaranteed to be in the same order they were generated.

👍
A 2xx status code response is expected from the partner backend. If the partner backend does not respond with a 2xx status code, the Theta Video API will keep retrying with exponential backoff.

Theta Video Service: Webhooks

Types of events that can be subscribed to

Example API request made from Theta Video API to the partner backend

📘
Use the Theta Video API to fetch the object. A URI to the object is added to the event for convenience.

🚧
Delivery of events is not guaranteed to be in the same order they were generated.

👍
A 2xx status code response is expected from the partner backend. If the partner backend does not respond with a 2xx status code, the Theta Video API will keep retrying with exponential backoff.

Types of events that can be subscribed to

Example API request made from Theta Video API to the partner backend

📘Use the Theta Video API to fetch the object. A URI to the object is added to the event for convenience.

🚧Delivery of events is not guaranteed to be in the same order they were generated.

👍A 2xx status code response is expected from the partner backend. If the partner backend does not respond with a 2xx status code, the Theta Video API will keep retrying with exponential backoff.

📘
Use the Theta Video API to fetch the object. A URI to the object is added to the event for convenience.

🚧
Delivery of events is not guaranteed to be in the same order they were generated.

👍
A 2xx status code response is expected from the partner backend. If the partner backend does not respond with a 2xx status code, the Theta Video API will keep retrying with exponential backoff.