API errors and status codes

When you call a Fades API, the HTTP status code tells you what happened.

Success

• 200 OK: it worked.
• 201 Created: something new was created.

Your request had a problem

• 400 Bad Request: something in the request is invalid. Check the body and parameters.
• 401 Unauthorized: you're not signed in or your token expired.
• 403 Forbidden: you're signed in but not allowed to do this.
• 404 Not Found: the thing or URL doesn't exist.
• 429 Too Many Requests: you're sending requests too fast. Wait and retry with backoff.

Our side had a problem

• 500 Internal Server Error: something broke on our end. Retry shortly.
• 502, 503, 504: a service is temporarily unavailable. Check the status page and retry.