Publishing API
Publishing API
Upload finished exports and publish them to connected social accounts as tracked async jobs.
The Publishing API moves a finished video from your storage to a connected social account. Uploads use resumable intents; publishes run as async jobs you poll or observe through webhooks.
The publishing flow
- Create an upload intent → receive a resumable upload URL and a mediaKey.
- PUT the file bytes to the upload URL (chunked, resumable).
- Create a job with the mediaKey and a target connectionId.
- Poll GET /v1/publishing/jobs/{id} or wait for your webhookUrl.
- On FAILED, call retry to resume from the last checkpoint.
Job states
| State | Meaning |
|---|---|
| QUEUED | Accepted and waiting for a worker |
| UPLOADING | Bytes are moving to the provider |
| PROCESSING | Provider is processing the media |
| COMPLETED | Published — response contains the provider URL |
| FAILED | Terminal error — call retry or inspect errorCode |
| CANCELLED | Cancelled before completion |
Was this page helpful?