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 errors

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

​
400

CodeTitleMessage
AUT-0001Missing Fields in RequestYour request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request.
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-0003Unexpected Fields in the RequestThe request body contains more fields than expected. Please send only the allowed fields as per the documentation. The unexpected fields are listed in the fields object.
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-0009Bad RequestThe server could not understand the request due to malformed syntax. Please check the listed fields and try 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.

​
Identity errors

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

​
400

CodeTitleMessage
IDE-0001Missing Fields in RequestYour request is missing one or more required fields.
IDE-0002Invalid Field Type in RequestThe provided field type in the request is invalid.
IDE-0003Invalid Path ParameterOne or more path parameters are in an incorrect format.
IDE-0004Unexpected Fields in the RequestThe request body contains more fields than expected. Please send only the allowed fields.
IDE-0005Invalid Query ParameterOne or more query parameters are in an incorrect format.
IDE-0007Bad RequestThe server could not understand the request due to malformed syntax.
IDE-0010Unmodifiable Field ErrorYour request includes a field that cannot be modified.
IDE-0011Immutable Field ErrorThe field cannot be modified. Please remove it from your request.
IDE-0012Invalid Application NameThe provided application name is invalid.
IDE-0013User ID Not MatchThe provided ID does not match the token owner.
IDE-0014Metadata Key Length ExceededThe metadata key exceeds the maximum allowed length.
IDE-0015Metadata Value Length ExceededThe metadata value exceeds the maximum allowed length.
IDE-0016Invalid Metadata NestingThe metadata object cannot contain nested values.
IDE-0017User Already ExistsThe user already exists. Please use a different username or email and try again.
IDE-0020Password Too ShortThe password must be at least 12 characters long.
IDE-0021Password No UppercaseThe password must contain at least one uppercase letter.
IDE-0022Password No LowercaseThe password must contain at least one lowercase letter.
IDE-0023Password No DigitThe password must contain at least one digit.
IDE-0024Password No Special CharThe password must contain at least one special character.
IDE-0025Password Consecutive RepeatedThe password must not contain consecutive repeated characters.
IDE-0026Password Unknown RuleUnknown password validation rule.
IDE-0027Old Password InvalidThe old password provided is invalid.

​
401

CodeTitleMessage
IDE-0008Token MissingA valid token must be provided in the request header.
IDE-0009Invalid TokenThe provided token is expired, invalid or malformed.

​
404

CodeTitleMessage
IDE-1001Application ID Not FoundThe provided application ID does not exist in our records.
IDE-1002No Applications FoundNo applications were found in the search.
IDE-1003User ID Not FoundThe provided user ID does not exist in our records.
IDE-1004No Users FoundNo users were found in the search.
IDE-1005No Groups FoundNo groups were found in the search.
IDE-1006Group ID Not FoundThe provided group ID does not exist in our records.

​
500

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