---
title: "Retry broadcast review"
method: POST
path: "/v1/broadcasts/{broadcastId}/retry-review"
---

# Retry broadcast review

`POST /v1/broadcasts/{broadcastId}/retry-review`

## Request

- Base URL: `https://api.zavu.dev`
- URL: `https://api.zavu.dev/v1/broadcasts/{broadcastId}/retry-review`
- Auth: HTTP bearer

Resubmit a rejected broadcast for AI review after editing content. Maximum 3 review attempts allowed per broadcast.

## Path parameters

- `broadcastId` string, required

## Response `200`

Review resubmitted.

- BroadcastResponse
  - `broadcast` Broadcast, required
    - `id` string, required
    - `name` string, required
    - `status` 'draft' | 'pending_review' | 'pending_admin_review' | 'approved' | 'rejected' | 'escalated' | 'rejected_final' | 'scheduled' | 'sending' | 'paused' | 'completed' | 'cancelled' | 'failed', required: Current status of the broadcast. `pending_review`: in the automated content review. `pending_admin_review`: the automated review passed and it waits for a person, which is where every channel but a WhatsApp broadcast on an approved template goes. `rejected`: the review refused it; edit it and retry the review, or escalate. `scheduled` and `sending` follow approval.
    - `channel` 'smart' | 'sms' | 'sms_oneway' | 'whatsapp' | 'telegram' | 'email', required: Broadcast delivery channel. Use 'smart' for per-contact intelligent routing.
    - `messageType` 'text' | 'image' | 'video' | 'audio' | 'document' | 'template', required: Type of message for broadcast.
    - `text` string
    - `content` BroadcastContent: Content for non-text broadcast message types.
      - `mediaUrl` string: URL of the media file.
      - `mediaId` string: Media ID if already uploaded.
      - `mimeType` string: MIME type of the media.
      - `filename` string: Filename for documents.
      - `templateId` string: Template ID for template messages.
      - `templateVariables` object: Default body variables (can be overridden per contact). Key them to match the template body: by position (`1`, `2`, ...) for positional templates, or by name (e.g. `customer_name`) for named templates. Zavu detects the template's format and sends the correct payload to Meta. Do not mix positional and named keys.
      - `templateButtonVariables` object: Default button variables for dynamic URL/OTP buttons. Keys are the button index (0, 1, 2). Per-contact values override these.
      - `templateHeaderVariables` object: Default value for a text-header variable, keyed by `1` (can be overridden per contact). If omitted, Zavu resolves the header from `templateVariables` by the header placeholder's name.
    - `senderId` string
    - `emailSubject` string
    - `totalContacts` integer, required: Total number of contacts in the broadcast.
    - `pendingCount` integer
    - `sendingCount` integer
    - `sentCount` integer: Recipients whose message the provider accepted, without a confirmed delivery yet. Channels that never report delivery keep their recipients here.
    - `deliveredCount` integer: Recipients with confirmed delivery to the device.
    - `failedCount` integer
    - `estimatedCost` number, nullable: Estimated total cost in USD.
    - `reservedAmount` number, nullable: Amount reserved from balance in USD.
    - `actualCost` number, nullable: Actual cost so far in USD.
    - `scheduledAt` string, date-time
    - `startedAt` string, date-time
    - `completedAt` string, date-time
    - `metadata` object
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time
    - `reviewResult` object, nullable: AI content review result.
      - `score` number: Content safety score from 0.0 to 1.0, where 1.0 is completely safe.
      - `categories` string[]: Policy categories violated, if any.
      - `reasoning` string: Explanation of the review decision.
      - `reviewedAt` string, date-time
      - `flaggedContent` string[], nullable: Problematic text fragments, if any.
    - `reviewAttempts` integer, nullable: Number of review attempts (max 3).

## Other responses

- `400`: Broadcast not in rejected status or max attempts reached.
- `401`: Unauthorized.
- `404`: Broadcast not found.

## Changes

> 80 revisions in range; 1 not diffed.

- **2026-07-07** `f467a4da6cd2`: 3 info
  - removed the `instagram` enum value from the `broadcast/channel` response property for the response status `200`
  - removed the `messenger` enum value from the `broadcast/channel` response property for the response status `200`
  - removed the `voice` enum value from the `broadcast/channel` response property for the response status `200`
- **2026-06-18** `a817a073a07f`: 1 warning
  - added the new `messenger` enum value to the `broadcast/channel` response property for the response status `200`
- **2026-05-28** `fe72e5565564`: 1 info
  - added the optional property `broadcast/content/templateHeaderVariables` to the response with the `200` status
- **2026-05-15** `3e45958691da`: 1 info
  - added the optional property `broadcast/content/templateButtonVariables` to the response with the `200` status

[Operation history](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/changes/v1/broadcasts/:broadcastId/retry-review/post.md)

---

[API](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api.md) - [All operations](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/revisions/75bc777b0ffb?raw)