How retries work
A delivery attempt fails when SafeFetch gets a non-2xx response, network error, or timeout. If attempts remain, the action returns topending with next_retry_at.
Backoff formula
attempt is 1-based after each failed attempt.
Backoff table
| Failed attempt | Delay before next try |
|---|---|
| 1 | 20s |
| 2 | 40s |
| 3 | 80s |
| 4 | 160s |
| 5 | 320s |
| … | capped at 3600s |
retries
- Set per action (
1to100, default3). - Once attempts are exhausted, action becomes
failed.
Failure callbacks
Ifcallback is set, SafeFetch sends a failure callback with status: failed and last_error when the action reaches terminal failure.
Monitoring retries
Use action reads/listing fields:retries_remaining: attempts leftnext_retry_in_seconds: countdown to next attemptlast_error: most recent failure reason