Skip to main content

​
Error Format

Every non-success response returns the same JSON envelope:
  • error — a stable, machine-readable code. Branch your integration logic on this.
  • message — a human-readable explanation. Log it; don’t parse it.

​
Status Codes

​
Handling Errors

  • 400 — a bad ID. Check that you’re passing the record’s UUID and not a name or a URL.
  • 401 — fix the credentials. Retrying won’t help until the key is corrected or replaced.
  • 403 — API access has been turned off for your organization. Contact support@cortado.pro.
  • 404 — treat as “the record isn’t available to this key”. It may have been deleted, or it may belong to another organization.
  • 429 — back off. Wait the seconds given in Retry-After (60) and retry.
Retrying is only useful for 429 and for network or 5xx failures. Retrying a 400, 401, 403, or 404 produces the same result and only burns rate limit.