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
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).
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 → API Keys, and check the permissioning for your key. Ensure it includes the required scopes for the endpoint you’re calling.