API keys and the REST API

Create keys in Settings → Developers. Choose the access level: Read only, Read & write videos or Admin. The key is shown once; store it somewhere safe.

Send it as a bearer token:

curl https://api.pellio.io/v1/videos 
  -H "Authorization: Bearer pk_…"

Uploading

Create an upload, then send the file to the returned URL. Processing starts when the upload is complete.

curl https://api.pellio.io/v1/videos/uploads 
  -H "Authorization: Bearer pk_…" 
  -H "Content-Type: application/json" 
  -d '{"title":"Onboarding","filename":"onboarding.mp4","size":48213377,"type":"video/mp4"}'

Every endpoint, with request and response schemas and an interactive console, is in the API reference. The OpenAPI document is at https://api.pellio.io/v1/openapi.json.

Requests are rate limited per key; a 429 response means slow down and retry.