API · errors
Errors
Scrwly uses one structured error shape across the versioned API. Every error includes a machine code and a request id.
Shape
{
"error": {
"code": "invalid_scene",
"message": "The scene failed validation.",
"requestId": "req_abc123",
"details": {
"issues": [
{
"path": "canvas.width",
"code": "invalid_type",
"message": "Required",
"severity": "error"
}
]
}
}
}Status codes
| Status | Meaning |
|---|---|
400 | Invalid request |
401 | Missing or invalid key |
403 | Provider not allowed on this plan |
404 | Not found |
413 | Prompt too large |
422 | Invalid scene |
429 | Rate limited |
500 | Internal error |