Retry backoff schedule API

Computes per-attempt retry delays for exponential/linear/fixed backoff with an optional cap and deterministic full/equal jitter, plus the total worst-case wait. Answers 'What delays should my retries use?', 'How long until I exhaust retries?'.

Price$0.02per request

MethodPOST

Route/v1/workflow/backoff-schedule

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

retrybackoffexponentialjitterscheduledelayresilienceworkflow

API URLhttps://x402.hexl.dev/v1/workflow/backoff-schedule

Integration docs

Example request

{
  "attempts": 4,
  "baseMs": 100,
  "strategy": "exponential",
  "capMs": 1000
}

Example response

{
  "schedule": [
    {
      "attempt": 1,
      "rawMs": 100,
      "delayMs": 100
    },
    {
      "attempt": 2,
      "rawMs": 200,
      "delayMs": 200
    },
    {
      "attempt": 3,
      "rawMs": 400,
      "delayMs": 400
    },
    {
      "attempt": 4,
      "rawMs": 800,
      "delayMs": 800
    }
  ],
  "totalDelayMs": 1500,
  "strategy": "exponential",
  "jitter": "none",
  "interpretation": "4 retries, exponential backoff (base 100ms), total worst-case wait 1500ms."
}

Input schema

{
  "type": "object",
  "required": [
    "attempts",
    "baseMs"
  ],
  "properties": {
    "attempts": {
      "type": "integer",
      "minimum": 1,
      "examples": [
        4
      ]
    },
    "baseMs": {
      "type": "number",
      "examples": [
        100
      ]
    },
    "strategy": {
      "type": "string",
      "enum": [
        "exponential",
        "linear",
        "fixed"
      ]
    },
    "factor": {
      "type": "number"
    },
    "capMs": {
      "type": "number",
      "examples": [
        1000
      ]
    },
    "jitter": {
      "type": "string",
      "enum": [
        "none",
        "full",
        "equal"
      ]
    },
    "seed": {}
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}