# A guide to errors and retries

- Date: 2026-10-29
- Type: New
- Surface: Developer portal and CLI
- What you need to do: Nothing.
- Address: https://developers.rivr.io/changelog/2026-10-29-guide-errors-retries

The new guide Errors and retries gives one way to handle errors against /api/public: read `code` and never the text, decide whether to send the call again from `Rivr-Should-Retry`, `retryWhen` or /errors.json, wait `Retry-After` when the answer has it and back off with jitter when it doesn't, and send the same `Idempotency-Key` again so that a retry after a lost answer never does anything twice. It lists which operations take an `Idempotency-Key` today and what a different body under the same key gets. Its Node example is a file Rivr's CI runs against a fake server, so the code you copy has been tried.