API
Errors
Complete catalog of API error codes, HTTP status codes, and troubleshooting resolutions.
Overview
All error responses from the Asiyst API return a consistent JSON schema with machine-readable error codes.
Error Response Schema
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"details": [
{ "field": "domain", "issue": "Must be a valid HTTPS URL." }
]
}
}
Common Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid Bearer token |
FORBIDDEN | 403 | Insufficient permissions or domain not allowed |
NOT_FOUND | 404 | Project, avatar, or document does not exist |
RATE_LIMIT_EXCEEDED | 429 | Exceeded requests per minute quota |
INTERNAL_ERROR | 500 | Transient cloud infrastructure error |