Error Codes
All errors follow this structure:
json
{
"error": "Human readable message",
"code": "ERROR_CODE" // present on quota errors
}HTTP Status Codes
| Status | Meaning |
|---|---|
200 | Success |
400 | Bad request — invalid verb, missing required field, schema mismatch |
401 | Unauthorized — missing, invalid or revoked token |
402 | Record limit reached — upgrade your plan |
403 | Forbidden — token doesn't have permission for this verb |
404 | Database or table not found |
429 | Monthly request limit reached — upgrade your plan |
500 | Internal server error |
Common errors
401 — Invalid token
json
{ "error": "Invalid or revoked token" }The token was revoked, doesn't exist, or the format is wrong.
403 — Permission denied
json
{ "error": "This token does not have 'insert' permission" }Create a new token with the required permission.
400 — Filters required
json
{ "error": "'filters' is required for update to prevent accidental full-table updates" }Always pass filters with update and delete.
429 — Request quota exceeded
json
{
"error": "Monthly request limit reached (1000 requests). Upgrade your plan.",
"code": "REQUESTS_EXCEEDED"
}You've used all your monthly API requests. Upgrade at celdrax.com/pricing.
402 — Record quota exceeded
json
{
"error": "Record limit reached (10000 records). Upgrade your plan.",
"code": "RECORDS_EXCEEDED"
}Your database has reached its record limit. Upgrade your plan or delete old records.
500 — Schema error
json
{ "error": "Invalid column name 'nonexistent_column'." }The column doesn't exist in the table. Check your table schema in the dashboard.