Errors
A request that can't be done answers with a 4xx status and a JSON body whose detail says
why, in words you can show:
{ "detail": "Your plan doesn't allow this" }
| Status | Means | What to do |
|---|---|---|
400 | The request asks for something that can't be | Fix the request |
401 | No token, or it's expired or revoked | Use a valid token (Authentication) |
402 | Your plan doesn't include it, or a limit is reached | Upgrade the plan, or make room |
403 | The token's role is too low, or tokens can't do this | Use a token with a higher role |
404 | It doesn't exist, or isn't in the token's project | Check the ID |
409 | Not now: the video is busy (encoding, being replaced, …) | Wait for its webhook, then try again |
422 | The body or parameters don't match the reference | detail lists each field that's wrong |
429 | Too many requests | Wait as long as Retry-After says (Rate limits) |
503 | A service Crumbcast needs is unavailable for a moment | Try again later |
A 422's detail is a list, one entry per field:
{
"detail": [
{ "loc": ["body", "size"], "msg": "Input should be greater than 0", "type": "greater_than" }
]
}