---
title: "Edit an unsent draft"
method: PATCH
path: "/v1/drafts/{id}"
tags: ["send"]
---

# Edit an unsent draft

`PATCH /v1/drafts/{id}`

## Request

- Base URL: `https://botmail.pro`
- URL: `https://botmail.pro/v1/drafts/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `bm_session`

Scope: send. Omitted fields are kept. 409 draft_closed once sent or discarded.

## Request body

- object
  - `to` union: One address string (may be "a@x, b@y") or an array of addresses.
    - string
    - string[]
  - `cc` union: One address string (may be "a@x, b@y") or an array of addresses.
    - string
    - string[]
  - `bcc` union: One address string (may be "a@x, b@y") or an array of addresses.
    - string
    - string[]
  - `subject` string
  - `text` string
  - `html` string

## Response `200`

The draft.

- Draft
  - `id` string, required: drf_…
  - `mailbox_id` string, required
  - `from` string, required
  - `to` string[], required
  - `cc` string[]
  - `bcc` string[]
  - `subject` string, required
  - `text` string
  - `html` string
  - `reply_to_message_id` string
  - `status` 'draft' | 'sent' | 'discarded', required
  - `sent_message_id` string
  - `review_url` string, uri: Only in the create response.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `409`: Conflicts with current state.

---

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