---
title: "Read-only policy simulation for fixed send requests to one recipient."
method: POST
path: "/v1/workspaces/{workspaceId}/communication-policy/simulate"
---

# Read-only policy simulation for fixed send requests to one recipient.

`POST /v1/workspaces/{workspaceId}/communication-policy/simulate`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/communication-policy/simulate`
- Auth: HTTP bearer

Does not change reservations or move dependent Journey steps.

## Request body

- object
  - `policy` CommunicationPolicy
    - `conflict` 'defer' | 'discard', required
    - `minimumIntervalSeconds` integer
    - `caps` object[]
      - `count` integer, required
      - `windowSeconds` integer, required
    - `window` object
      - `start` string, required
      - `end` string, required
      - `timeZone` string, required
      - `weekdays` integer[]
  - `history` string[]
  - `requests` object[], required
    - `id` string, required
    - `at` string, date-time, required
    - `category` 'urgent' | 'product' | 'promotional', required
    - `source_kind` 'journey' | 'broadcast', required
    - `expiresAt` string, date-time
    - `deliveryBlocked` boolean

## Response `200`

Per-request send, defer, or discard decision timeline with reasons.

- object
  - `data` object, required
    - `policy` CommunicationPolicy, required
      - `conflict` 'defer' | 'discard', required
      - `minimumIntervalSeconds` integer
      - `caps` object[]
        - `count` integer, required
        - `windowSeconds` integer, required
      - `window` object
        - `start` string, required
        - `end` string, required
        - `timeZone` string, required
        - `weekdays` integer[]
    - `policy_version` integer, nullable, required
    - `timeline` object[], required
      - `id` string, required
      - `source_kind` 'journey' | 'broadcast', required
      - `requested_at` string, date-time, required
      - `action` 'send' | 'defer' | 'discard', required
      - `at` string, date-time, required
      - `reason` string, required
    - `scope` 'one_recipient_fixed_send_requests', required
    - `warnings` string[], required

---

[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)