Skip to main content

Errors — Status Codes and Handling

HTTPMeaningWhat to Do
200 / 201Success—
400Validation or precondition failedRead message; do not retry without changing the request.
401Auth failedCheck the API key. Do not retry with the same key.
403ForbiddenCheck organization_id and space_id.
404Resource not foundIf a known booking returns 404, remove from your dedupe mapping.
409Conflict (rare)Refresh state via GET /api/bookings/{id} and re-decide.
429Rate limit (not enforced today)Back off exponentially.
5xxServer errorRetry with backoff: 1s, 2s, 5s, 15s, 1m, give up. Alert a human.