Rest API Errors Reference
PlusAuth uses HTTP response status codes to indicate whether a specific request has been successfully completed. Response Content-Type will be application/json
, which means it will be in json
format. You can find error name, status code and a description (if there is one) in the response json.
Status codes in 2xx
range will indicate success on the other hand codes in range 4xx-5xx
will indicate error.
5xx
errors are extremely rare and those are happened at PlusAuth servers. Our team will be notified immediately in such cases and the error will be resolved in the soonest time.
PlusAuth errors structure is as following:
PlusAuth Error Responses
400 | invalid_request | The request was unacceptable, probably because of wrong parameter. |
400 | unsupported_view_template | Unsupported view template provided. |
402 | plan_limit_exceeded | You exceeded the limit of your subscription plan for provided operation. Consider upgrading your plan. |
401 | invalid_audience | Incorrect audience is used in access token. |
401 | invalid_issuer | Access token is meant to be used for another tenant. |
401 | invalid_authorization_scheme | Wrong authorization scheme is used. It must be 'Bearer'. |
401 | missing_scope | Required scope (permission) is missing in token. |
401 | missing_token | Authorization token is not provided. |
401 | unauthorized_user | User is not authorized for the action/tenant. |
404 | entity_not_found | Requested resource doesn't exist. |
409 | already_exists | Provided resource already exists. |
422 | invalid_entity | The request was unacceptable, probably because of an incorrect or missing parameter. |
429 | too_many_requests | Too many requests received. For more details have a look at to Rate Limits |
5xx | server_error | Something is wrong at PlusAuth. These errors are extremely rare and will be resolved in the soonest time. |