Complete reference of API error codes and their meanings.
Error Codes
All API errors follow this format:
{
"error": {
"code": "ERROR_CODE",
"message": "Human-readable description",
"details": {}
}
}
Error code reference
Client errors (4xx)
| Code | HTTP Status | Description |
|---|---|---|
VALIDATION_ERROR | 400 | Request body or parameters are invalid. Check the details field for specifics. |
INVALID_VERSION | 400 | Version string is not valid SemVer. |
INVALID_NAME | 400 | Skill or org name doesn't match naming rules. |
MISSING_FIELD | 400 | A required field is missing from the request. |
UNAUTHORIZED | 401 | No authentication provided, or the token is invalid/expired. |
INVALID_TOKEN | 401 | The provided token does not exist or has been revoked. |
SESSION_EXPIRED | 401 | The session cookie has expired. Log in again. |
FORBIDDEN | 403 | Authenticated but lacking permission for this operation. |
INSUFFICIENT_SCOPE | 403 | Token doesn't have the required scope (e.g., publish scope needed). |
NOT_MEMBER | 403 |