Access Manager Error List

The Access Manager returns consistent and structured error responses. This helps you quickly understand what went wrong and how to fix it.

Error Format

{  
   "code": "<error_code>",  
   "title": "<error_title>",  
   "message": "<error_message>"  
}

Field Definitions

  • code – A stable, unique identifier for the error. Useful for programmatic handling and support requests.
  • title – A short, human-readable summary of the issue.
  • message – Detailed guidance to help you resolve the error.

This structure ensures you always get actionable feedback when something doesn’t go as expected.


Auth Plugin Errors


The following errors can occur when interacting with the Auth Plugin endpoints. Each error follows our standard structure, making it easier to debug and respond to issues programmatically.

Refer to the table below for a list of possible error codes, what they mean, and how to resolve them.


400

CodeTitleMessage
AUT-0002Invalid Path ParameterOne or more path parameters are in an incorrect format. Please check the following parameters %v and ensure they meet the required format before trying again.
AUT-0004Invalid Query ParameterOne or more query parameters are in an incorrect format. Please check the following parameters %v and ensure they meet the required format before trying again.
AUT-0010Metadata Key Length ExceededThe metadata key %v exceeds the maximum allowed length of %v characters. Please use a shorter key.
AUT-0011Metadata Value Length ExceededThe metadata value %v exceeds the maximum allowed length of %v characters. Please use a shorter value.
AUT-0012Invalid Metadata NestingThe metadata object cannot contain nested values. Please ensure that the value %v is not nested and try again.
AUT-0013Invalid Grant TypeThe provided 'grantType' %s is not valid. Accepted grant types are password, client_credentials, refresh_token, or others. Please provide a valid type.
AUT-0014Grant Type Missing FieldsThe provided 'grant_type' %s is missing required fields. Please refer to the documentation for guidance.
AUT-1001Unsupported Grant TypeThe provided 'grantType' is not supported by this application. Please refer to the application's supported grant types.
AUT-1005Invalid Refresh TokenThe provided 'refreshToken' is invalid, expired or revoked. Please verify the token and try again.

401

CodeTitleMessage
AUT-0006Token MissingA valid token must be provided in the request header. Please include a token and try again.
AUT-0007Invalid TokenThe provided token is expired, invalid or malformed. Please provide a valid token and try again.
AUT-1003Invalid TokenThe provided token is expired, invalid or malformed. Please provide a valid token and try again.
AUT-1002Invalid Username or PasswordThe provided 'username' or 'password' is incorrect. Please verify the credentials and try again.
AUT-1004Invalid ClientThe provided 'clientId' or 'clientSecret' is incorrect. Please verify the credentials and try again.

403

CodeTitleMessage
AUT-0008Permission Enforcement ErrorThe enforcer is not configured properly. Please contact your administrator if you believe this is an error.

404

CodeTitleMessage
AUT-1015Enforcement Sub Not FoundNo subject was found for the provided 'sub'. Please refer to the enforcement documentation for guidance on the correct 'sub' value.

500

CodeTitleMessage
AUT-0005Internal Server ErrorThe server encountered an unexpected error. Please try again later or contact support.