Responses
Status codes and retry guidance.
| Status | Error | Meaning |
|---|---|---|
202 | none, body { "id": "..." } | Event accepted. |
400 | invalid_json, invalid_thread_id | Bad request body or thread id. |
401 | missing_api_key, invalid_api_key | Check X-Api-Key. |
402 | billing details in body | Billing is suspended. |
403 | client_id_mismatch | Key does not own this CLIENT_ID. |
404 | thread_not_found | Unknown THREAD_ID. |
413 | event_too_large | Payload over size limit. |
429 | pipeline_full, rate_limited, concurrency_limited | Slow down and retry. |
503 | pipeline_closed | Sarama is shutting down. Retry. |
Retry
- Retry
429and503with backoff. Honor theRetry-Afterheader on429. - Do not retry
400,401,403,404,413.