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.