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

Code	Title	Message
AUT-0002	Invalid Path Parameter	One 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-0004	Invalid Query Parameter	One 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-0010	Metadata Key Length Exceeded	The metadata key %v exceeds the maximum allowed length of %v characters. Please use a shorter key.
AUT-0011	Metadata Value Length Exceeded	The metadata value %v exceeds the maximum allowed length of %v characters. Please use a shorter value.
AUT-0012	Invalid Metadata Nesting	The metadata object cannot contain nested values. Please ensure that the value %v is not nested and try again.
AUT-0013	Invalid Grant Type	The provided 'grantType' %s is not valid. Accepted grant types are password, client_credentials, refresh_token, or others. Please provide a valid type.
AUT-0014	Grant Type Missing Fields	The provided 'grant_type' %s is missing required fields. Please refer to the documentation for guidance.
AUT-1001	Unsupported Grant Type	The provided 'grantType' is not supported by this application. Please refer to the application's supported grant types.
AUT-1005	Invalid Refresh Token	The provided 'refreshToken' is invalid, expired or revoked. Please verify the token and try again.

401

Code	Title	Message
AUT-0006	Token Missing	A valid token must be provided in the request header. Please include a token and try again.
AUT-0007	Invalid Token	The provided token is expired, invalid or malformed. Please provide a valid token and try again.
AUT-1003	Invalid Token	The provided token is expired, invalid or malformed. Please provide a valid token and try again.
AUT-1002	Invalid Username or Password	The provided 'username' or 'password' is incorrect. Please verify the credentials and try again.
AUT-1004	Invalid Client	The provided 'clientId' or 'clientSecret' is incorrect. Please verify the credentials and try again.

403

Code	Title	Message
AUT-0008	Permission Enforcement Error	The enforcer is not configured properly. Please contact your administrator if you believe this is an error.

404

Code	Title	Message
AUT-1015	Enforcement Sub Not Found	No subject was found for the provided 'sub'. Please refer to the enforcement documentation for guidance on the correct 'sub' value.

500

Code	Title	Message
AUT-0005	Internal Server Error	The server encountered an unexpected error. Please try again later.

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

Code	Title	Message
IDE-0001	Missing Fields in Request	Your request is missing one or more required fields.
IDE-0002	Invalid Field Type in Request	The provided field type in the request is invalid.
IDE-0003	Invalid Path Parameter	One or more path parameters are in an incorrect format.
IDE-0004	Unexpected Fields in the Request	The request body contains more fields than expected. Please send only the allowed fields.
IDE-0005	Invalid Query Parameter	One or more query parameters are in an incorrect format.
IDE-0007	Bad Request	The server could not understand the request due to malformed syntax.
IDE-0010	Unmodifiable Field Error	Your request includes a field that cannot be modified.
IDE-0011	Immutable Field Error	The field cannot be modified. Please remove it from your request.
IDE-0012	Invalid Application Name	The provided application name is invalid.
IDE-0013	User ID Not Match	The provided ID does not match the token owner.
IDE-0014	Metadata Key Length Exceeded	The metadata key exceeds the maximum allowed length.
IDE-0015	Metadata Value Length Exceeded	The metadata value exceeds the maximum allowed length.
IDE-0016	Invalid Metadata Nesting	The metadata object cannot contain nested values.
IDE-0017	User Already Exists	The user already exists. Please use a different username or email and try again.
IDE-0020	Password Too Short	The password must be at least 12 characters long.
IDE-0021	Password No Uppercase	The password must contain at least one uppercase letter.
IDE-0022	Password No Lowercase	The password must contain at least one lowercase letter.
IDE-0023	Password No Digit	The password must contain at least one digit.
IDE-0024	Password No Special Char	The password must contain at least one special character.
IDE-0025	Password Consecutive Repeated	The password must not contain consecutive repeated characters.
IDE-0026	Password Unknown Rule	Unknown password validation rule.
IDE-0027	Old Password Invalid	The old password provided is invalid.

401

Code	Title	Message
IDE-0008	Token Missing	A valid token must be provided in the request header.
IDE-0009	Invalid Token	The provided token is expired, invalid or malformed.

404

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

500

Code	Title	Message
IDE-0006	Internal Server Error	The server encountered an unexpected error. Please try again later.