---
title: "Unschedule a broadcast"
method: DELETE
path: "/v1/broadcasts/{broadcast_id}/schedule"
tags: ["Broadcasts"]
---

# Unschedule a broadcast

`DELETE /v1/broadcasts/{broadcast_id}/schedule`

## Request

- Base URL: `https://api.mailrith.com`
- URL: `https://api.mailrith.com/v1/broadcasts/{broadcast_id}/schedule`
- Auth: HTTP bearer

Returns a scheduled Broadcast to draft state before delivery starts.

## Path parameters

- `broadcast_id` string, required

## Response `200`

Broadcast returned to draft

- object
  - `data` Broadcast, required
    - `self` string, required: Stable relative Public API path for retrieving this resource.
    - `id` string, required
    - `subject` string, required
    - `preview_text` string, nullable, required
    - `body` string, required
    - `body_document` BroadcastEmailDocument, required
      - `type` 'doc' | 'paragraph' | 'heading' | 'text' | 'hardBreak' | 'bulletList' | 'orderedList' | 'listItem' | 'blockquote' | 'emailSection' | 'emailSectionColumn' | 'emailButton' | 'image' | 'horizontalRule', required
      - `attrs` object
        - `id` string
        - `level` 1 | 2 | 3
        - `textAlign` 'left' | 'center' | 'right' | 'justify'
        - `columns` 1 | 2 | 3
        - `width` 'default' | 'large' | 'full' | 'fit'
        - `backgroundColor` string
        - `blockquoteBorderColor` string
        - `linkColor` string
        - `layoutAlignment` 'left' | 'center'
        - `backgroundImageUrl` string
        - `margin` 'none' | 'normal' | 'large'
        - `padding` 'none' | 'normal' | 'large'
        - `borderColor` string
        - `borderWidth` 'none' | 'normal' | 'large'
        - `borderRadius` 'none' | 'normal' | 'small' | 'large' | 'full'
        - `verticalAlign` 'top' | 'middle' | 'bottom'
        - `href` string
        - `textColor` string
        - `size` 'small' | 'medium' | 'large'
        - `align` 'left' | 'center' | 'right'
        - `label` string
        - `src` string
        - `alt` string
        - `title` string
        - `caption` string
        - `source` 'unsplash'
        - `unsplash` object
          - `photoId` string
          - `photographerName` string, required
          - `photographerUsername` string
          - `photographerUrl` string
          - `unsplashUrl` string
        - `widthPercent` number
        - `crop` 'none' | 'square' | 'circle'
        - `fillColumn` boolean
      - `content` BroadcastEmailNode[]
        - `type` 'doc' | 'paragraph' | 'heading' | 'text' | 'hardBreak' | 'bulletList' | 'orderedList' | 'listItem' | 'blockquote' | 'emailSection' | 'emailSectionColumn' | 'emailButton' | 'image' | 'horizontalRule', required
        - `attrs` object
          - `id` string
          - `level` 1 | 2 | 3
          - `textAlign` 'left' | 'center' | 'right' | 'justify'
          - `columns` 1 | 2 | 3
          - `width` 'default' | 'large' | 'full' | 'fit'
          - `backgroundColor` string
          - `blockquoteBorderColor` string
          - `linkColor` string
          - `layoutAlignment` 'left' | 'center'
          - `backgroundImageUrl` string
          - `margin` 'none' | 'normal' | 'large'
          - `padding` 'none' | 'normal' | 'large'
          - `borderColor` string
          - `borderWidth` 'none' | 'normal' | 'large'
          - `borderRadius` 'none' | 'normal' | 'small' | 'large' | 'full'
          - `verticalAlign` 'top' | 'middle' | 'bottom'
          - `href` string
          - `textColor` string
          - `size` 'small' | 'medium' | 'large'
          - `align` 'left' | 'center' | 'right'
          - `label` string
          - `src` string
          - `alt` string
          - `title` string
          - `caption` string
          - `source` 'unsplash'
          - `unsplash` object
            - `photoId` string
            - `photographerName` string, required
            - `photographerUsername` string
            - `photographerUrl` string
            - `unsplashUrl` string
          - `widthPercent` number
          - `crop` 'none' | 'square' | 'circle'
          - `fillColumn` boolean
        - `content` BroadcastEmailNode[]
        - `text` string
        - `marks` BroadcastEmailMark[]
          - `type` 'bold' | 'italic' | 'strike' | 'underline' | 'link' | 'textStyle' | 'highlight', required
          - `attrs` object
            - `href` string
            - `color` string
            - `fontSize` string
      - `text` string
      - `marks` BroadcastEmailMark[]
        - `type` 'bold' | 'italic' | 'strike' | 'underline' | 'link' | 'textStyle' | 'highlight', required
        - `attrs` object
          - `href` string
          - `color` string
          - `fontSize` string
    - `status` 'draft' | 'scheduled' | 'running' | 'completed' | 'failed', required
    - `scheduled_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `connection_id` string, nullable, required
    - `from_name` string, nullable, required
    - `from_email` string, nullable, required
    - `reply_to_email` string, nullable, required
    - `audience_definition` AudienceDefinition, required
      - `match` 'all' | 'any', required
      - `groups` AudienceConditionGroup[], required
        - `id` string, required
        - `match` 'all' | 'any', required
        - `conditions` AudienceCondition[], required
          - `id` string, required
          - `field` 'subscriber_status' | 'country' | 'segment' | 'tag' | 'sequence' | 'form' | 'custom_field' | 'email_opened' | 'email_unsubscribed' | 'magic_link_clicked', required
          - `operator` 'is' | 'is_not' | 'has_any_of' | 'has_none_of' | 'is_active_in_any_of' | 'is_not_active_in_any_of' | 'has_completed_any_of' | 'has_not_completed_any_of' | 'has_ever_been_in_any_of' | 'has_never_been_in_any_of' | 'contains' | 'does_not_contain' | 'is_empty' | 'is_not_empty' | 'before' | 'after' | 'on' | 'in_last_days' | 'greater_than' | 'less_than' | 'in_region' | 'not_in_region', required
          - `value` union
            - string
            - number
            - boolean
            - string[]
          - `customFieldId` string, nullable
    - `track_opens` boolean, required
    - `track_clicks` boolean, required
    - `utm_source` string, nullable, required
    - `utm_medium` string, nullable, required
    - `utm_campaign` string, nullable, required
    - `utm_term` string, nullable, required
    - `utm_content` string, nullable, required
    - `recipient_count` integer, required
    - `opened_count` integer, required
    - `clicked_count` integer, required
    - `unsubscribed_count` integer, required
    - `bounced_count` integer, required
    - `complained_count` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `409`: The Broadcast already started or cannot be changed in its current state.

---

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