Error Codes
All API errors return a consistent JSON structure with a code and message.
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid authentication |
FORBIDDEN | 403 | Insufficient permissions for this action |
NOT_FOUND | 404 | Resource does not exist |
VALIDATION_ERROR | 400 | Request body failed validation |
PLAN_LIMIT | 403 | Action exceeds your plan's limits |
RATE_LIMITED | 429 | Too many requests |
INTERNAL_ERROR | 500 | Unexpected server error |