Errors you can act on.
MindLarp returns standard HTTP status codes and a consistent JSON error envelope.
{
"error": {
"message": "Invalid API key.",
"type": "authentication_error",
"code": "invalid_api_key"
}
}Status codes
| Status | Meaning | What to do |
|---|---|---|
| 400 | Invalid request | Check fields and parameter types. |
| 401 | Authentication failed | Verify the key and bearer header. |
| 403 | Insufficient scope | Use a key with the required scope. |
| 404 | Unknown model or route | Check the identifier and URL. |
| 429 | Rate limit | Retry with exponential backoff. |
| 503 | Inference not configured | Configure the model service upstream. |
Retry safely
Retry 429 and 5xx responses with exponential backoff and jitter. Do not retry 400, 401, or 403 responses without changing the request. Set client timeouts so your application remains responsive.
Limits
The local API accepts request bodies up to 1 MB. Model-level rate and token limits should be enforced by your deployed inference service.
