Reference7 min~170 words
Rate limits and errors
Limit headers, retry behaviour, error envelopes and common error codes.
Rate limit
Each API key can make 120 requests per minute. The counter is durable and consumed after authentication. Successful authenticated responses return the limit, remaining requests and reset time.
| Header | Meaning |
|---|---|
X-RateLimit-Limit | Maximum requests in the current window. |
X-RateLimit-Remaining | Requests remaining after the current call. |
X-RateLimit-Reset | ISO timestamp for the window reset. |
Retry-After | Seconds to wait; returned with HTTP 429. |
Error envelope
Example HTTP 403
{
"ok": false,
"request_id": "23a0bc77-07bf-4f54-bc4b-466700288668",
"error": {
"code": "PAID_PLAN_REQUIRED",
"message": "An active paid Aetherion plan is required to use the API.",
"details": {
"plan": "free",
"subscription_status": "inactive"
}
}
}| HTTP | Common code | Meaning |
|---|---|---|
| 400 | MISSING_PROJECT_ID / INVALID_FILE_PATH | A required identifier or path is invalid. |
| 401 | MISSING_API_KEY / INVALID_API_KEY | Bearer authentication failed. |
| 403 | PAID_PLAN_REQUIRED / SENSITIVE_FILE_BLOCKED | The account or requested resource is not allowed. |
| 404 | PROJECT_NOT_FOUND / PROJECT_FILE_NOT_FOUND | The owned resource does not exist. |
| 413 | PROJECT_FILE_TOO_LARGE | File content is larger than 1,000,000 bytes. |
| 429 | RATE_LIMIT_EXCEEDED | Wait until the returned reset time. |
| 500 | API_CONFIGURATION_ERROR / load-specific code | The server could not complete a safe response. |
Need project-specific help?
Open the private Help Center or create a support ticket with the affected project, route and request ID.