---
title: "Resume one lane, domain or mailbox pause after reviewing its rates and sources."
method: POST
path: "/v1/workspaces/{workspaceId}/sending-health/resume"
---

# Resume one lane, domain or mailbox pause after reviewing its rates and sources.

`POST /v1/workspaces/{workspaceId}/sending-health/resume`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/sending-health/resume`
- Auth: HTTP bearer

Workspace admin only. Allowed 24 hours after a lane or domain pause and once per 30 days per domain. A repeat pause within 30 days or a frozen workspace needs Banger review and is refused with 423. After a resume the lane sends in smaller batches for 24 hours; held Broadcasts and Journeys continue automatically.

## Request body

- object
  - `hold_id` string, uuid, required: The pause (hold.id) from getSendingHealth.
  - `acknowledge_reputation_risk` true, required
  - `reason` string: What was fixed; recorded in the audit log.

## Response `200`

The pause was released.

- object
  - `data` object, required
    - `resumed` SendingHold, required
      - `id` string, uuid, required
      - `scope` 'mailbox' | 'lane' | 'domain' | 'workspace', required
      - `state` 'warning' | 'paused' | 'frozen', required
      - `reason` string, required: bounce_rate, complaint_rate, core_lane_paused, multiple_lanes_paused, repeat_lane_pause, multiple_domains_paused, complaint_burst or operator_review.
      - `started_at` string, date-time, required
      - `review_required` boolean, required
      - `evidence` object, required
      - `resume` object, required
        - `self_serve` boolean, required
        - `blocked_reason` string, nullable, required
        - `resumable_at` string, date-time, nullable, required
      - `top_sources` object[]
        - `signal` 'hard_bounce' | 'complaint', required
        - `source` string, required
        - `source_id` string, nullable, required
        - `count` integer, required
      - `top_recipient_domains` object[]
        - `signal` 'hard_bounce' | 'complaint', required
        - `recipient_domain` string, required
        - `count` integer, required
    - `probation_until` string, date-time, nullable, required
    - `health` SendingHealth, required
      - `workspace` object, required
        - `state` 'active' | 'frozen', required
        - `hold` SendingHold, required
          - `id` string, uuid, required
          - `scope` 'mailbox' | 'lane' | 'domain' | 'workspace', required
          - `state` 'warning' | 'paused' | 'frozen', required
          - `reason` string, required: bounce_rate, complaint_rate, core_lane_paused, multiple_lanes_paused, repeat_lane_pause, multiple_domains_paused, complaint_burst or operator_review.
          - `started_at` string, date-time, required
          - `review_required` boolean, required
          - `evidence` object, required
          - `resume` object, required
            - `self_serve` boolean, required
            - `blocked_reason` string, nullable, required
            - `resumable_at` string, date-time, nullable, required
          - `top_sources` object[]
            - `signal` 'hard_bounce' | 'complaint', required
            - `source` string, required
            - `source_id` string, nullable, required
            - `count` integer, required
          - `top_recipient_domains` object[]
            - `signal` 'hard_bounce' | 'complaint', required
            - `recipient_domain` string, required
            - `count` integer, required
      - `domains` object[], required
        - `domain_id` string, uuid, required
        - `domain` string, required
        - `product_id` string, uuid, nullable, required
        - `state` 'active' | 'paused', required
        - `hold` SendingHold, required
          - `id` string, uuid, required
          - `scope` 'mailbox' | 'lane' | 'domain' | 'workspace', required
          - `state` 'warning' | 'paused' | 'frozen', required
          - `reason` string, required: bounce_rate, complaint_rate, core_lane_paused, multiple_lanes_paused, repeat_lane_pause, multiple_domains_paused, complaint_burst or operator_review.
          - `started_at` string, date-time, required
          - `review_required` boolean, required
          - `evidence` object, required
          - `resume` object, required
            - `self_serve` boolean, required
            - `blocked_reason` string, nullable, required
            - `resumable_at` string, date-time, nullable, required
          - `top_sources` object[]
            - `signal` 'hard_bounce' | 'complaint', required
            - `source` string, required
            - `source_id` string, nullable, required
            - `count` integer, required
          - `top_recipient_domains` object[]
            - `signal` 'hard_bounce' | 'complaint', required
            - `recipient_domain` string, required
            - `count` integer, required
        - `lanes` object[], required
          - `lane_kind` 'mailbox' | 'product' | 'broadcast', required
          - `sending_stream_id` string, uuid, required
          - `from_domain` string, required
          - `state` 'active' | 'warning' | 'paused', required
          - `probation_until` string, date-time, nullable, required
          - `rates` SendingRates, required
            - `window_hours` integer, required
            - `volume` integer, required: Sends in the window (the larger of sent and delivered plus hard bounced).
            - `hard_bounced` integer, required
            - `complained` integer, required
            - `bounce_rate` number, required
            - `complaint_rate` number, required
            - `small_sender` boolean, required: Fewer than the minimum volume; absolute counts apply.
          - `hold` SendingHold, required
            - `id` string, uuid, required
            - `scope` 'mailbox' | 'lane' | 'domain' | 'workspace', required
            - `state` 'warning' | 'paused' | 'frozen', required
            - `reason` string, required: bounce_rate, complaint_rate, core_lane_paused, multiple_lanes_paused, repeat_lane_pause, multiple_domains_paused, complaint_burst or operator_review.
            - `started_at` string, date-time, required
            - `review_required` boolean, required
            - `evidence` object, required
            - `resume` object, required
              - …
            - `top_sources` object[]
              - …
            - `top_recipient_domains` object[]
              - …
      - `mailboxes` object[], required
        - `mailbox_id` string, uuid, required
        - `address` string, required
        - `product_id` string, uuid, nullable, required
        - `state` 'paused', required
        - `hold` SendingHold, required
          - `id` string, uuid, required
          - `scope` 'mailbox' | 'lane' | 'domain' | 'workspace', required
          - `state` 'warning' | 'paused' | 'frozen', required
          - `reason` string, required: bounce_rate, complaint_rate, core_lane_paused, multiple_lanes_paused, repeat_lane_pause, multiple_domains_paused, complaint_burst or operator_review.
          - `started_at` string, date-time, required
          - `review_required` boolean, required
          - `evidence` object, required
          - `resume` object, required
            - `self_serve` boolean, required
            - `blocked_reason` string, nullable, required
            - `resumable_at` string, date-time, nullable, required
          - `top_sources` object[]
            - `signal` 'hard_bounce' | 'complaint', required
            - `source` string, required
            - `source_id` string, nullable, required
            - `count` integer, required
          - `top_recipient_domains` object[]
            - `signal` 'hard_bounce' | 'complaint', required
            - `recipient_domain` string, required
            - `count` integer, required
      - `thresholds` object, required: The enforced thresholds (src/sending/reputation-policy.ts).

## Other responses

- `409`: Too early to resume (sending_resume_too_early), or a lane of a paused domain (sending_domain_paused).
- `423`: Needs Banger review (sending_resume_review_required, sending_resume_limit_reached, sending_workspace_frozen).

---

[API](https://skmtc.dev/bangermail/apis/banger-api.md) · [All operations](https://skmtc.dev/bangermail/apis/banger-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bangermail/apis/banger-api/revisions/a149909267f9?raw)