Errors & Status Codes
BizXEngine uses standard HTTP status codes. Every error response includes a machine-readable code and a human-readable message.
Error format
{
"error": {
"code": "memory_not_found",
"message": "No memory with ID mem_xyz in workspace ws_abc123.",
"request_id": "req_Kx8mN7..."
}
}Status codes
| HTTP | Code | Description |
|---|---|---|
| 400 | invalid_request | Missing required parameter or invalid value. |
| 401 | unauthorized | API key missing or malformed. |
| 403 | forbidden | Key valid but lacks permission for this resource. |
| 404 | not_found | Resource does not exist. |
| 409 | conflict | Duplicate memory detected (see dedup). |
| 422 | unprocessable | Request well-formed but semantically invalid. |
| 429 | rate_limited | Too many requests. Check Retry-After header. |
| 500 | internal_error | Something went wrong on our end. Contact support with the request_id. |