Skip to main content

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" }
StatusMeansWhat to do
400The request asks for something that can't beFix the request
401No token, or it's expired or revokedUse a valid token (Authentication)
402Your plan doesn't include it, or a limit is reachedUpgrade the plan, or make room
403The token's role is too low, or tokens can't do thisUse a token with a higher role
404It doesn't exist, or isn't in the token's projectCheck the ID
409Not now: the video is busy (encoding, being replaced, …)Wait for its webhook, then try again
422The body or parameters don't match the referencedetail lists each field that's wrong
429Too many requestsWait as long as Retry-After says (Rate limits)
503A service Crumbcast needs is unavailable for a momentTry 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" }
]
}