> ## Documentation Index
> Fetch the complete documentation index at: https://portkey-docs-chore-v2-11-2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> Error codes returned by the Admin API and how to resolve them.

# Admin API Error Codes

Below is a list of error codes returned by the Portkey Admin API. These help with debugging failed requests and ensuring proper authentication, permissions, and request formatting.

## Error Reference

| Error Code | HTTP Status | Message                                 | Type         |
| ---------- | ----------- | --------------------------------------- | ------------ |
| AB01       | 400         | Request Validation Error                | Client Error |
| AB02       | 404         | Request Validation Error                | Client Error |
| AB03       | 403         | User not allowed to access the resource | Client Error |
| AB04       | 500         | Internal Server Error                   | Server Error |
| AB05       | 401         | Unauthorized access                     | Client Error |
| AB06       | 429         | Rate limit exceeded                     | Client Error |
| AB07       | 409         | Resource already exists                 | Client Error |
| AB08       | 404         | Resource not found                      | Client Error |
| AB09       | 402         | Subscription exhausted                  | Client Error |

***

## Notes on Common Errors

<Note>
  **AB01 – Request Validation Error (400)**

  This error usually happens when:

  * You're either missing required parameters
  * using incorrect data types (e.g., sending a number instead of a string)
  * passing values that are not within the allowed set (enum violations).
</Note>

<Note>
  **AB05 – Unauthorized Access (401)**

  This indicates that the user is not authorized to access the resource, often due to incorrect API key permissions.

  **Common Cause**: Your API key does **not have the right permissions** for this request.

  **Fix**: Go to [app.portkey.ai](https://app.portkey.ai) → **API Keys**, and check the permissioning for your key. Ensure it includes the required scopes for the endpoint you're calling.
</Note>