WebhookRetryConfig

Retry policy applied to failed deliveries (network errors, non-2xx responses).

  • backoffStrategy
    Type: stringenum
    required

    How retry backoff grows. exponential (default) doubles the delay each attempt up to maxBackoff (capped further by maxDoublings); linear adds minBackoff each attempt; constant waits minBackoff between every retry.

    values
    • exponential
    • linear
    • constant
  • jitter
    Type: stringenum
    required

    Randomization applied to the computed backoff. full multiplies the delay by a random factor between 1 and 2 (prevents the thundering-herd problem when many retries align); none (default) uses the exact computed delay.

    values
    • full
    • none
  • maxAttempts
    Type: integer
    required

    Maximum number of delivery attempts before the delivery is marked failed. Default: 20.

  • maxBackoff
    Type: integer
    required

    Cap on backoff (in seconds) between retries. Once exponential growth hits this value, every subsequent retry waits this long. Default: 43200 (12 hours).

  • maxDoublings
    Type: integer
    required

    Caps how many times the exponential backoff doubles before flattening at maxBackoff. Only meaningful when backoffStrategy: "exponential". Default: 10.

  • maxRetryDuration
    Type: integer
    required

    Maximum total time (in seconds) the delivery is retried before being marked failed, regardless of maxAttempts. Default: 259200 (3 days).

  • minBackoff
    Type: integer
    required

    Initial backoff (in seconds) before the first retry. Default: 60 (1 minute).