Resources
Error code index
A single reference for the error codes the API returns. Codes appear in error.code (envelope) or as HTTP status codes.
Request validation
| Code | Meaning | Fix |
|---|---|---|
40001 | Request could not be routed (missing method) | Use a valid endpoint path from the reference. |
40002 | Request could not be routed (missing resource) | Check the endpoint path. |
40003 | Invalid method in the request | Use a standard HTTP method on a valid path. |
40004 | Unrecognized resource in the path | Check the endpoint path against the reference. |
40005 | Invalid JSON body | Send well-formed JSON with Content-Type: application/json. |
Authentication
| Code | Meaning | Fix |
|---|---|---|
5200 | Missing DB connection (non-public) | Check your tenant slug is valid. |
5202 | Invalid app credential params | Send app_id, app_secret, namespace. |
5203 | App auth failed (no match) | Wrong secret, or key not active/published. |
5204 | Invalid token params | Send token, user_id, tenant. |
5205 | Token not found / mismatch | Re-issue the user token. |
5206 | General auth failed | No auth method succeeded. |
5207 | Token expired / revoked | Refresh the user token. |
5208 | Database error (token auth) | Retry; contact support with request_id. |
5209 | Rate limit exceeded (auth attempts) | Back off - 10 attempts/min per IP. |
HTTP status codes
| Status | Meaning |
|---|---|
| 200 | Success (check success in the body - some legacy endpoints return 200 on failure). |
| 400 | Bad request - invalid or missing parameter. |
| 401 | Unauthorized - authentication failed. |
| 403 | Forbidden - authenticated but not allowed. |
| 404 | Not found. |
| 412 | Precondition failed (conditional request). |
| 429 | Too many requests - honor Retry-After. |
| 500 | Internal server error - retry, then contact support with request_id. |
| 503 | Service unavailable. |
Note
Every error response includes a
request_id. Include it in support requests so we can trace the exact call.