> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# 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**

<CodeGroup>
  ```jsonon JSON theme={null}
  {
     "code": "<error_code>",
     "title": "<error_title>",
     "message": "<error_message>"
  }
  ```
</CodeGroup>

**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 APIs](/en/reference/access-manager/am-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](/en/reference/access-manager/am-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. |
