REST API

What you can do

• Upload videos straight to storage, with resumable uploads in 16 MB parts for large files.
• Import a video from a link to a file.
• Read and manage your library and webhooks from your own code.
• Give each key only the access it needs: Read only, Read & write videos or Admin.

Set it up

1. In Pellio, go to Settings → Developers. You need to be an owner or admin.
2. Create a key: give it a name and choose its Access.
3. Copy the key. It’s shown once, so store it somewhere safe.
4. Send it as a bearer token: curl https://api.pellio.io/v1/videos -H "Authorization: Bearer pk_…"
5. To upload, call POST /v1/videos/uploads, PUT the file to the returned URL, then call POST /v1/videos/{id}/complete. A video.ready webhook tells you when it’s processed.

Good to know

• Every endpoint is in the API reference, and the OpenAPI document is at https://api.pellio.io/v1/openapi.json.
• Files must be video or audio, up to 20 GB. Upload URLs are valid for 6 hours.
• Each key can make 600 requests a minute and 30 imports a minute. A 429 response means slow down and retry.
• The key list shows when each key was last used. Revoke stops a key at once.
• Needs the Standard plan or above.

Full guide: API keys.