{
"code": "<error_code>",
"title": "<error_title>",
"message": "<error_message>"
}
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.
Auth errors
The following errors can occur when interacting with the Auth APIs endpoints. Each error follows our standard structure, making it easier to debug and respond to issues programmatically.
400
code | title | message |
|---|---|---|
| AUT-0001 | Missing Fields in Request | Your request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request. |
| AUT-0002 | Invalid Path Parameter | One or more path parameters are in an incorrect format. Please check the following parameters and ensure they meet the required format before trying again. |
| AUT-0003 | Unexpected Fields in the Request | The 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-0004 | Invalid Query Parameter | One or more query parameters are in an incorrect format. Please check the following parameters and ensure they meet the required format before trying again. |
| AUT-0009 | Bad Request | The server could not understand the request due to malformed syntax. Please check the listed fields and try again. |
| AUT-0010 | Metadata Key Length Exceeded | The metadata key exceeds the maximum allowed length. Please use a shorter key. |
| AUT-0011 | Metadata Value Length Exceeded | The metadata value exceeds the maximum allowed length. Please use a shorter value. |
| AUT-0012 | Invalid Metadata Nesting | The metadata object cannot contain nested values. Please ensure that the value is not nested and try again. |
| AUT-0013 | Invalid Grant Type | The provided ‘grantType’ 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’ 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. |
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-1002 | Invalid Username or Password | The provided ‘username’ or ‘password’ is incorrect. Please verify the credentials and try again. |
| AUT-1003 | Invalid Token | The provided token is expired, invalid or malformed. Please provide a valid token and try again. |
| AUT-1004 | Invalid Client | The provided ‘clientId’ or ‘clientSecret’ is incorrect. Please verify the credentials and try again. |
| AUT-1005 | Invalid Refresh Token | The provided ‘refreshToken’ is invalid, expired or revoked. Please verify the token 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 or contact support. |
Identity errors
The following errors can occur when interacting with the Identity APIs 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. Please check the parameters and ensure they meet the required format before trying again. |
| 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 of 100 characters. Please use a shorter key. |
| IDE-0015 | Metadata Value Length Exceeded | The metadata value exceeds the maximum allowed length of 2000 characters. Please use a shorter value. |
| IDE-0016 | Invalid Metadata Nesting | The metadata object cannot contain nested values. Please ensure that the value is not nested and try again. |
| 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. Please include a token and try again. |
| IDE-0009 | Invalid Token | The provided token is expired, invalid or malformed. Please provide a valid token and try again. |
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. |