Error Codes
Troubleshoot problems with this comprehensive breakdown of all error codes.
Troubleshoot problems with this comprehensive breakdown of all error codes.
Error Schema
We use standard HTTP response codes for success and failure notifications, and our errors are further classified by type.
invalid_required_field
Status: 400
Message: Bad Request
Suggested action: Check the error message to see what went wrong.
missing_or_invalid_token
Status: 401
Message:
{"detail": "Not authenticated"} when the request has no Authorization: Bearer <access_token> header; {"detail": "Could not validate credentials"} when its token is invalid or expired; {"detail": "Token revoked"} when its token was revoked.Suggested action: Send the
Authorization: Bearer <access_token> header, with a token from /auth/token. Get a new token before its expires_at, or right away if yours was revoked.HTTP_406_NOT_ACCEPTABLE
Status: 406
Message: Unauthorized
Suggested action: Take a look at the error message as it indicates the value is outside ranges.
internal_server_error
Status: 500
Message: An unexpected error occurred.
Suggested action: Try the request again later.
bad_gateway
Status: 502
Message: Sometimes it's just an internal connection error that will be reported as BAD gateway.
Suggested action: Try the request again later.
service_unavailable
Status: 503
Message: Service is temporarily unavailable due to maintenance.
Suggested action: Try the request again later.