> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openmail.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete email draft

> Permanently discard an unsent draft and its stored attachments without sending email. Requires the exact saved updatedAt. Stale versions and pending or accepted sends cannot be deleted. Scoped API keys may delete only drafts in their inbox or pod. MCP OAuth requires send permission. Missing or already removed drafts return 404.



## OpenAPI

````yaml https://api.openmail.sh/openapi.json delete /v1/drafts/{draftId}
openapi: 3.0.3
info:
  title: OpenMail API
  description: >-
    Email infrastructure API for AI agents. Create inboxes, send and receive
    email, and get real-time notifications via webhooks.
  version: 1.0.0
  license:
    name: Proprietary
servers:
  - url: https://api.openmail.sh
security:
  - bearerAuth: []
tags:
  - name: pods
    description: Isolated sub-accounts for your end users or tenants
  - name: inboxes
    description: Email inboxes and their webhook configuration
  - name: domains
    description: >-
      Custom domains: add your own sending/receiving domain, publish DNS, and
      verify it
  - name: owned-domains
    description: >-
      Domains your organisation controls but does not send from. Prove ownership
      with one TXT record and mail to their addresses stops counting toward the
      cold outreach limits.
  - name: messages
    description: Sending and listing messages
  - name: drafts
    description: Create, view, edit and send saved email drafts
  - name: threads
    description: Conversation threads and read status
  - name: attachments
    description: Downloading and extracting text from attachments
  - name: policy
    description: >-
      Correspondent policy — provider-enforced allow/block rules and allowlist
      mode, scoped per account, pod, or inbox. Account-wide key only.
  - name: limits
    description: >-
      Sending limits: today's cold outreach caps on new recipients, per account,
      inbox, and domain, and what raises them
  - name: webhooks
    description: >-
      Webhook endpoints: where events are sent, how each request is
      authenticated, and the delivery log. Account-wide key only.
  - name: feedback
    description: Reporting bugs, friction, and feature requests to the OpenMail team
paths:
  /v1/drafts/{draftId}:
    delete:
      tags:
        - drafts
      summary: Delete email draft
      description: >-
        Permanently discard an unsent draft and its stored attachments without
        sending email. Requires the exact saved updatedAt. Stale versions and
        pending or accepted sends cannot be deleted. Scoped API keys may delete
        only drafts in their inbox or pod. MCP OAuth requires send permission.
        Missing or already removed drafts return 404.
      operationId: deleteDraft
      parameters:
        - schema:
            type: string
            minLength: 1
          in: path
          name: draftId
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - updatedAt
              properties:
                updatedAt:
                  type: string
                  format: date-time
                  description: >-
                    Exact updatedAt of the draft to discard. Never substitute a
                    newer version automatically.
                inboxId:
                  type: string
                  minLength: 1
                  description: Optional ownership check; must match the draft's inbox.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - deleted
                properties:
                  id:
                    type: string
                  deleted:
                    type: boolean
                    enum:
                      - true
        '400':
          description: Invalid draft or pagination
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing, invalid, or expired credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Inbox is outside the API key scope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Inbox or draft not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Draft changed, is sending, or has an accepted send
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      additionalProperties: true
      properties:
        error:
          type: string
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.