Multi-Language
Troubleshooting

Error Handling & HTTP Status Codes — OQENS SDK

Standard error objects, HTTP status codes, and troubleshooting guide.

Standard HTTP status codes returned by the DBaaS gateway.

HTTP Status Codes

Status Name Cause & Resolution
400 Bad Request Invalid SQL syntax, missing required payload fields, or banned SQL command.
401 Unauthorized Missing or invalid project API key (oq_live_...).
404 Not Found Project slug or table does not exist.
409 Conflict Unique constraint violation (e.g. duplicate email during auth.signUp).
500 Internal Error PostgreSQL connection failure or cluster capacity limit.
Copied