Skip to main content
When the API can’t complete a request, it responds with an error: a status code, such as 404, and a message that explains what went wrong. The status code tells you the kind of problem, and the message tells you what to fix. The exact format of the message depends on the API family. To tell the families apart, see Conventions.

Status codes

Error formats

Most errors put messages in a detail array:
When a background job failed, the item also has the job id and status:
Schema validation errors (422) add the location of the invalid field:
Authentication errors (401) use a different shape:

Read any error message

This helper returns a readable message from any CrazyGoldFish error response:

When to retry