API error codes and solutions
What to do on 401, 403, 409, 429 and 503 responses.
3 minute read
API errors are returned with the error, message, statusCode and requestId fields.
| Code | Likely cause | What to do |
|---|---|---|
401 | Key missing, wrong, revoked or expired | Check the header; rotate the key if necessary. |
403 | The key lacks the required scope | Create a new key with the right scopes. |
409 | The same Idempotency-Key was used with a different body | Generate a new key for every new operation. |
429 | Plan quota or rate limit exceeded | Wait for Retry-After; check your usage in the console. |
503 | Temporary billing outage (write operations) | Retry with the same Idempotency-Key. |
Never share your key in a support request; send the X-Request-Id from the response instead. For details, see the Errors and limits documentation.
Was this guide helpful?
More guides on this topic
Still not solved?
If you mention the name of this guide, we can help you faster.