Errors

Status codes and how to handle them.

StatusMeaningWhat to do
400The request is malformed or missing a fieldFix the request; the body explains which field
401The key is missing or invalidCheck the Authorization header and key
403The key cannot access this workspace or sessionUse a key for the right workspace
404The resource does not existCheck IDs and paths
429Too many requestsBack off and retry with increasing delays
5xxA problem on our sideRetry with backoff; treat gate errors as a block

Error body

{
  "error": {
    "message": "Field 'action' is required"
  }
}
Last reviewed October 2026Suggest a change