AgentMail Drafts API
The drafts API from AgentMail — 3 operation(s) for drafts.
The drafts API from AgentMail — 3 operation(s) for drafts.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/agentmail:agentmail-drafts-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Reference Drafts API
version: 1.0.0
servers:
- url: https://api.agentmail.to
description: prod
- url: https://x402.api.agentmail.to
description: prod-x402
- url: https://mpp.api.agentmail.to
description: prod-mpp
- url: https://api.agentmail.eu
description: eu-prod
tags:
- name: Drafts
paths:
/v0/drafts:
get:
operationId: drafts_list
summary: List Drafts
description: '**CLI:**
```bash
agentmail drafts list
```'
tags:
- Drafts
parameters:
- name: limit
in: query
required: false
schema:
$ref: '#/components/schemas/Limit'
- name: page_token
in: query
required: false
schema:
$ref: '#/components/schemas/PageToken'
- name: labels
in: query
required: false
schema:
$ref: '#/components/schemas/Labels'
- name: before
in: query
required: false
schema:
$ref: '#/components/schemas/Before'
- name: after
in: query
required: false
schema:
$ref: '#/components/schemas/After'
- name: ascending
in: query
required: false
schema:
$ref: '#/components/schemas/Ascending'
responses:
'200':
description: Response with status 200
content:
application/json:
schema:
$ref: '#/components/schemas/drafts_ListDraftsResponse'
'404':
description: Error response with status 404
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- Bearer: []
/v0/drafts/{draft_id}:
get:
operationId: drafts_get
summary: Get Draft
description: '**CLI:**
```bash
agentmail drafts get --draft-id
```'
tags:
- Drafts
parameters:
- name: draft_id
in: path
required: true
schema:
$ref: '#/components/schemas/drafts_DraftId'
responses:
'200':
description: Response with status 200
content:
application/json:
schema:
$ref: '#/components/schemas/drafts_Draft'
'404':
description: Error response with status 404
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- Bearer: []
/v0/drafts/{draft_id}/attachments/{attachment_id}:
get:
operationId: drafts_getAttachment
summary: Get Attachment
description: '**CLI:**
```bash
agentmail drafts get-attachment --draft-id --attachment-id
```'
tags:
- Drafts
parameters:
- name: draft_id
in: path
required: true
schema:
$ref: '#/components/schemas/drafts_DraftId'
- name: attachment_id
in: path
required: true
schema:
$ref: '#/components/schemas/attachments_AttachmentId'
responses:
'200':
description: Response with status 200
content:
application/json:
schema:
$ref: '#/components/schemas/attachments_AttachmentResponse'
'404':
description: Error response with status 404
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- Bearer: []
components:
schemas:
drafts_ListDraftsResponse:
type: object
properties:
count:
$ref: '#/components/schemas/Count'
limit:
$ref: '#/components/schemas/Limit'
next_page_token:
$ref: '#/components/schemas/PageToken'
drafts:
type: array
items:
$ref: '#/components/schemas/drafts_DraftItem'
description: Ordered by `updated_at` descending.
required:
- count
- drafts
title: ListDraftsResponse
attachments_AttachmentSize:
type: integer
description: Size of attachment in bytes.
title: AttachmentSize
ErrorCode:
type: string
description: Stable, machine-readable error code in snake_case (for example, not_found or missing_permission). Branch on this rather than the message text.
title: ErrorCode
drafts_DraftBcc:
type: array
items:
type: string
description: Addresses of BCC recipients. In format `username@domain.com` or `Display Name <username@domain.com>`.
title: DraftBcc
drafts_DraftId:
type: string
description: ID of draft.
title: DraftId
drafts_Draft:
type: object
properties:
inbox_id:
$ref: '#/components/schemas/inboxes_InboxId'
draft_id:
$ref: '#/components/schemas/drafts_DraftId'
client_id:
$ref: '#/components/schemas/drafts_DraftClientId'
labels:
$ref: '#/components/schemas/drafts_DraftLabels'
reply_to:
$ref: '#/components/schemas/drafts_DraftReplyTo'
to:
$ref: '#/components/schemas/drafts_DraftTo'
cc:
$ref: '#/components/schemas/drafts_DraftCc'
bcc:
$ref: '#/components/schemas/drafts_DraftBcc'
subject:
$ref: '#/components/schemas/drafts_DraftSubject'
preview:
$ref: '#/components/schemas/drafts_DraftPreview'
text:
$ref: '#/components/schemas/drafts_DraftText'
html:
$ref: '#/components/schemas/drafts_DraftHtml'
attachments:
$ref: '#/components/schemas/drafts_DraftAttachments'
in_reply_to:
$ref: '#/components/schemas/drafts_DraftInReplyTo'
forward_of:
$ref: '#/components/schemas/drafts_DraftForwardOf'
references:
type: array
items:
type: string
description: IDs of previous messages in thread.
send_status:
$ref: '#/components/schemas/drafts_DraftSendStatus'
send_at:
$ref: '#/components/schemas/drafts_DraftSendAt'
updated_at:
$ref: '#/components/schemas/drafts_DraftUpdatedAt'
created_at:
type: string
format: date-time
description: Time at which draft was created.
required:
- inbox_id
- draft_id
- labels
- updated_at
- created_at
title: Draft
attachments_AttachmentResponse:
type: object
properties:
attachment_id:
$ref: '#/components/schemas/attachments_AttachmentId'
filename:
$ref: '#/components/schemas/attachments_AttachmentFilename'
size:
$ref: '#/components/schemas/attachments_AttachmentSize'
content_type:
$ref: '#/components/schemas/attachments_AttachmentContentType'
content_disposition:
$ref: '#/components/schemas/attachments_AttachmentContentDisposition'
content_id:
$ref: '#/components/schemas/attachments_AttachmentContentId'
download_url:
type: string
description: Signed HTTPS CDN URL to download the attachment bytes. Retrieve a fresh URL when needed rather than storing it permanently.
text_url:
type: string
description: Signed HTTPS CDN URL to download extracted plain text, when available. Omitted when no extracted text is available. Expires at the same time as download_url.
expires_at:
type: string
format: date-time
description: Time at which download_url and text_url (when present) expire. Retrieve the attachment again to obtain fresh URLs.
required:
- attachment_id
- size
- download_url
- expires_at
title: AttachmentResponse
attachments_AttachmentContentDisposition:
type: string
enum:
- inline
- attachment
description: Content disposition of attachment.
title: AttachmentContentDisposition
drafts_DraftPreview:
type: string
description: Text preview of draft.
title: DraftPreview
Count:
type: integer
description: Number of items returned.
title: Count
drafts_DraftLabels:
type: array
items:
type: string
description: Labels of draft.
title: DraftLabels
After:
type: string
format: date-time
description: Timestamp after which to filter by.
title: After
ErrorDocs:
type: string
description: Link to the error reference entry for this code.
title: ErrorDocs
drafts_DraftForwardOf:
type: string
description: ID of message being forwarded.
title: DraftForwardOf
Before:
type: string
format: date-time
description: Timestamp before which to filter by.
title: Before
attachments_AttachmentId:
type: string
description: ID of attachment.
title: AttachmentId
attachments_Attachment:
type: object
properties:
attachment_id:
$ref: '#/components/schemas/attachments_AttachmentId'
filename:
$ref: '#/components/schemas/attachments_AttachmentFilename'
size:
$ref: '#/components/schemas/attachments_AttachmentSize'
content_type:
$ref: '#/components/schemas/attachments_AttachmentContentType'
content_disposition:
$ref: '#/components/schemas/attachments_AttachmentContentDisposition'
content_id:
$ref: '#/components/schemas/attachments_AttachmentContentId'
required:
- attachment_id
- size
title: Attachment
drafts_DraftHtml:
type: string
description: HTML body of draft.
title: DraftHtml
ErrorMessage:
type: string
description: Error message.
title: ErrorMessage
drafts_DraftClientId:
type: string
description: Client ID of draft.
title: DraftClientId
inboxes_InboxId:
type: string
description: The ID of the inbox.
title: InboxId
drafts_DraftUpdatedAt:
type: string
format: date-time
description: Time at which draft was last updated.
title: DraftUpdatedAt
drafts_DraftInReplyTo:
type: string
description: ID of message being replied to.
title: DraftInReplyTo
attachments_AttachmentContentType:
type: string
description: Content type of attachment.
title: AttachmentContentType
drafts_DraftText:
type: string
description: Plain text body of draft.
title: DraftText
Labels:
type: array
items:
type: string
description: Labels to filter by.
title: Labels
attachments_AttachmentContentId:
type: string
description: Content ID of attachment.
title: AttachmentContentId
drafts_DraftReplyTo:
type: array
items:
type: string
description: Reply-to addresses. In format `username@domain.com` or `Display Name <username@domain.com>`.
title: DraftReplyTo
drafts_DraftSendAt:
type: string
format: date-time
description: Time at which to schedule send draft.
title: DraftSendAt
drafts_DraftAttachments:
type: array
items:
$ref: '#/components/schemas/attachments_Attachment'
description: Attachments in draft.
title: DraftAttachments
drafts_DraftCc:
type: array
items:
type: string
description: Addresses of CC recipients. In format `username@domain.com` or `Display Name <username@domain.com>`.
title: DraftCc
ErrorFix:
type: string
description: The concrete next action that resolves the error.
title: ErrorFix
Limit:
type: integer
description: Limit of number of items returned.
title: Limit
drafts_DraftTo:
type: array
items:
type: string
description: Addresses of recipients. In format `username@domain.com` or `Display Name <username@domain.com>`.
title: DraftTo
drafts_DraftItem:
type: object
properties:
inbox_id:
$ref: '#/components/schemas/inboxes_InboxId'
draft_id:
$ref: '#/components/schemas/drafts_DraftId'
labels:
$ref: '#/components/schemas/drafts_DraftLabels'
to:
$ref: '#/components/schemas/drafts_DraftTo'
cc:
$ref: '#/components/schemas/drafts_DraftCc'
bcc:
$ref: '#/components/schemas/drafts_DraftBcc'
subject:
$ref: '#/components/schemas/drafts_DraftSubject'
preview:
$ref: '#/components/schemas/drafts_DraftPreview'
attachments:
$ref: '#/components/schemas/drafts_DraftAttachments'
in_reply_to:
$ref: '#/components/schemas/drafts_DraftInReplyTo'
forward_of:
$ref: '#/components/schemas/drafts_DraftForwardOf'
send_status:
$ref: '#/components/schemas/drafts_DraftSendStatus'
send_at:
$ref: '#/components/schemas/drafts_DraftSendAt'
updated_at:
$ref: '#/components/schemas/drafts_DraftUpdatedAt'
required:
- inbox_id
- draft_id
- labels
- updated_at
title: DraftItem
drafts_DraftSubject:
type: string
description: Subject of draft.
title: DraftSubject
Ascending:
type: boolean
description: Sort in ascending temporal order.
title: Ascending
ErrorName:
type: string
description: Name of error.
title: ErrorName
attachments_AttachmentFilename:
type: string
description: Filename of attachment.
title: AttachmentFilename
drafts_DraftSendStatus:
type: string
enum:
- scheduled
- sending
- failed
description: Schedule send status of draft.
title: DraftSendStatus
PageToken:
type: string
description: Page token for pagination.
title: PageToken
ErrorResponse:
type: object
properties:
name:
$ref: '#/components/schemas/ErrorName'
code:
$ref: '#/components/schemas/ErrorCode'
message:
$ref: '#/components/schemas/ErrorMessage'
fix:
$ref: '#/components/schemas/ErrorFix'
docs:
$ref: '#/components/schemas/ErrorDocs'
required:
- name
- message
title: ErrorResponse
securitySchemes:
Bearer:
type: http
scheme: bearer
x-provenance:
method: harvested
publisher: AgentMail
source: https://docs.agentmail.to/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)