> ## Documentation Index
> Fetch the complete documentation index at: https://portkey-docs-chore-backend-change-log.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>

***

<Card title="Portkey is now PRISMA AIRS AI Gateway. See it in action." href="https://www.paloaltonetworks.in/ai-security/ai-gateway?utm_source=portkey&utm_medium=referral&utm_campaign=prisma_airs&utm_content=docs_nav#contact" icon="arrow-up-right-from-square">
  Contact Us
</Card>


## Related topics

- [Errors](/api-reference/inference-api/error-codes.md)
- [Common Errors & Resolutions](/support/common-errors-and-resolutions.md)
- [Get errors data](/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-errors-data.md)
- [Get error rate data](/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-error-rate-data.md)
- [Unified LLM API with Automatic Failover & Error Handling](/guides/use-cases/enterprise-ready-unified-api.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.