Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
JSON error envelope, status codes, and which failures stay on the run.
{
"error": "Human-readable message",
"code": "UNAUTHORIZED"
}
| Status | Code | When |
|---|---|---|
| 400 | INVALID_REQUEST | Body failed validation |
| 400 | INVALID_CURSOR | cursor is not a valid page token |
| 401 | UNAUTHORIZED | Missing, malformed, or revoked API key |
| 402 | CREDITS_INSUFFICIENT | Not enough reserved credits to admit the turn |
| 404 | CHAT_NOT_FOUND | Unknown chat, or a chat owned by someone else |
| 404 | RUN_NOT_FOUND | Run id is missing or not in that chat |
| 404 | UNKNOWN_TOOL | /tools/{name} is not crop, GPT Image 2, or merge |
| 409 | RUN_ACTIVE | This chat already has a turn in progress |
| 429 | RATE_LIMITED | Send window exceeded. Retry-After is set |
| 504 | TIMEOUT | A direct Magica tool poll timed out |
504. Send and completion return queued. Timeouts, model failures, and credit stops show up later as FAILED on the run snapshot, with errorCode and errorMessage.409 RUN_ACTIVE and poll the existing runId.