Skip to content

Error Codes

All errors follow this structure:

json
{
  "error": "Human readable message",
  "code":  "ERROR_CODE"   // present on quota errors
}

HTTP Status Codes

StatusMeaning
200Success
400Bad request — invalid verb, missing required field, schema mismatch
401Unauthorized — missing, invalid or revoked token
402Record limit reached — upgrade your plan
403Forbidden — token doesn't have permission for this verb
404Database or table not found
429Monthly request limit reached — upgrade your plan
500Internal 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.