> This page is for version V3 - Beta (default).
> For other versions, use one of these documentation indexes:
> - V3 - Beta (default): https://docs.authlyx.dev/v3/llms.txt
> - V2 - Legacy: https://docs.authlyx.dev/v2/llms.txt
> - V1 - End of support: https://docs.authlyx.dev/v1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.authlyx.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.authlyx.dev/_mcp/server.

# Errors and response messages

> Handle failed requests without checking English text.

## Check codes, not messages

The developer can customize many display messages in app settings. They cannot change machine-readable codes or make a denied request successful. Use `result.ok` or the HTTP response's verified `success` field to check the outcome.

| HTTP status | Meaning                                       | What your app should do                             |
| ----------- | --------------------------------------------- | --------------------------------------------------- |
| 400         | Invalid request                               | Check the documented fields                         |
| 401         | Invalid session, credentials or request proof | Read the code; request a new login when appropriate |
| 403         | Access denied by identity, app policy or plan | Show the server message and stop the denied action  |
| 404         | Record, value, channel or release not found   | Check the name and application                      |
| 413         | Body too large                                | Keep V3 request JSON within 16 KB                   |
| 415         | Wrong content type                            | Send application/json                               |
| 429         | Rate limited                                  | Respect Retry-After; avoid retry loops              |
| 503         | A required service/check is unavailable       | Report a connection problem; do not extend access   |

## Common V3 codes

| Code                                                                          | Meaning                                                                     |
| ----------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `INVALID_REQUEST`                                                             | Missing or invalid request fields                                           |
| `INVALID_PROOF`                                                               | Missing, expired or invalid installation signature                          |
| `REQUEST_TIME_INVALID`                                                        | Request timestamp is outside the accepted window                            |
| `REQUEST_REPLAYED`                                                            | This request nonce was already used                                         |
| `INVALID_CREDENTIALS`                                                         | Username or password is incorrect                                           |
| `LICENSE_NOT_FOUND`, `DEVICE_NOT_FOUND`                                       | The license key or device is not registered in this app                     |
| `USER_BANNED`, `LICENSE_BANNED`, `MOTHERBOARD_BANNED`, `PROCESSOR_BANNED`     | That user, license or device is banned                                      |
| `USER_SUSPENDED`, `LICENSE_PAUSED`, `MOTHERBOARD_PAUSED`, `PROCESSOR_PAUSED`  | That user, license or device is paused                                      |
| `USER_EXPIRED`, `LICENSE_EXPIRED`, `MOTHERBOARD_EXPIRED`, `PROCESSOR_EXPIRED` | That user, license or device has expired                                    |
| `DEVICE_NOT_ALLOWED`                                                          | The license or user is locked to a different system ID                      |
| `DEVICE_LIMIT_REACHED`                                                        | All device slots are in use                                                 |
| `ACCESS_REVOKED`                                                              | Access or its binding is no longer valid                                    |
| `SESSION_EXPIRED`                                                             | Session or access deadline has ended                                        |
| `COUNTRY_BLOCKED`                                                             | Connection country is blocked                                               |
| `LOCATION_UNAVAILABLE`                                                        | Required IP country could not be resolved                                   |
| `VPN_BLOCKED`                                                                 | VPN/proxy policy rejects the connection                                     |
| `IP_BLOCKED`, `SID_BLOCKED`                                                   | The IP address or system ID is on the app's blocklist                       |
| `IP_NOT_WHITELISTED`, `SID_NOT_WHITELISTED`                                   | The app uses an allowlist and this connection is not on it                  |
| `UPDATE_REQUIRED`                                                             | This app version is no longer allowed; the response includes update details |
| `INVALID_HASH`                                                                | This build's hash is not approved                                           |
| `APP_DISABLED`                                                                | The application is paused by its developer                                  |
| `VPN_CHECK_UNAVAILABLE`                                                       | Required reputation lookup did not complete                                 |
| `OFFLINE_DISABLED`                                                            | App has not enabled an offline window                                       |
| `CURRENT_PASSWORD_INVALID`                                                    | Current app password is incorrect                                           |
| `APP_VALUE_NOT_FOUND`                                                         | Cloud variable does not exist in this app                                   |
| `RATE_LIMITED`                                                                | Too many requests                                                           |
| `SIGNING_UNAVAILABLE`                                                         | Server signing is unavailable                                               |

Each code above matches an entry on the dashboard's **Responses** page, where you can reword its message. This is a common-code list, not every application-specific response. Each endpoint lists its response status codes. Include `requestId` when asking support about a request; omit credentials and bearer tokens.

## Connection failures

A local timeout cannot fetch a customized server message. SDK connection errors are separate from an explicit ban or expiry. Keep signed access only until its allowed deadline. Never close the host application automatically.