Skip to main content
Version: Current

HttpDisposition

@rotorsoft/act-root

@rotorsoft/act-root / act-http/src/webhook / HttpDisposition

Type Alias: HttpDisposition

HttpDisposition = "ok" | "retry" | "block"

Defined in: libs/act-http/src/webhook/classify.ts:19

Three buckets for an HTTP response from an outbound delivery:

  • ok — the receiver accepted the delivery (2xx). Stop and return.
  • retry — the receiver had a transient problem (5xx). Throw a retryable error; drain will pace the next attempt per backoff.
  • block — the receiver rejected the delivery permanently (3xx or 4xx). Throw a non-retryable error; drain blocks the stream on the first failed attempt (when blockOnError is true) and surfaces it via the "blocked" lifecycle event.

The 3xx → block mapping is intentional: a redirect at the delivery layer means the configured URL is wrong, and retrying the same URL won't fix that. Manual operator review is the right next step, which is what the block path produces.