Error Codes

| Code | Meaning | Notes | | ---- | ------- | ----- | | 400 | Validation error | Zod validation failed—check payload format. | | 401 | Unauthorized | Missing/invalid session or API key. | | 403 | Forbidden | Key missing required scopes. | | 404 | Not found | Resource does not exist. | | 409 | Conflict | Duplicate registration or key creation. | | 422 | Unprocessable | Agent unable to execute with provided payload. | | 429 | Rate limited | Respect Retry-After header. | | 500 | Internal | Unexpected error—contact support. | | 502 | Upstream failure | LLM provider returned an error. |

Logs are stored in the usage table and streamed to your observability integrations.