AgentMail drafts API is one of 29 APIs that AgentMail publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.
Tagged areas include Drafts. The published artifact set on APIs.io includes an OpenAPI specification, an AsyncAPI specification, API documentation, and an API reference.
This API exposes
3 operations
across 3 paths,
and defines 42 schemas.
It is described by OpenAPI 3.2.0, at version 1.0.0.
Requests are made against 4 base URLs: https://api.agentmail.to, https://x402.api.agentmail.to, https://mpp.api.agentmail.to, https://api.agentmail.eu.
3 operations3 paths42 schemas3 GET
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.agentmail.to
Authentication
HTTP Bearer
Resource Areas
1
Authentication & Security 1
AgentMail drafts API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (Bearer).
Paths & Operations 3
Across 3 paths, the API surfaces 3 operations — 3 GET. Each is listed below with its method, path, parameters, and response codes.
drafts 3
GET
/v0/drafts
List Drafts
list7 params→ 200404
GET
/v0/drafts/{draft_id}
Get Draft
get2 params→ 200404
GET
/v0/drafts/{draft_id}/attachments/{attachment_id}
Get Attachment
get-attachment3 params→ 200404
Schemas 42
The contract defines 42 schemas that model the data the API accepts and returns. The most detailed are type_drafts_Draft (20 properties), type_drafts_DraftItem (14 properties), type_attachments_AttachmentResponse (8 properties), type_attachments_Attachment (6 properties). Each schema is shown below with its type and property counts.
type__Labels
array
Labels to filter by.
type__Before
string
Timestamp before which to filter by.
type_drafts_DraftBcc
array
Addresses of BCC recipients. In format username@domain.com or Display Name .
type_drafts_DraftPreview
string
Text preview of draft.
type_drafts_DraftTo
array
Addresses of recipients. In format username@domain.com or Display Name .
type_attachments_AttachmentId
string
ID of attachment.
type_attachments_AttachmentSize
integer
Size of attachment in bytes.
type_drafts_Draft
object
20 properties5 required
type_attachments_Attachment
object
6 properties2 required
type_drafts_ListDraftsResponse
object
4 properties2 required
type_drafts_DraftId
string
ID of draft.
type_drafts_DraftText
string
Plain text body of draft.
type_drafts_DraftReplyTo
array
Reply-to addresses. In format username@domain.com or Display Name .
type__ErrorFix
string
The concrete next action that resolves the error.
type__Count
integer
Number of items returned.
type_drafts_DraftInReplyTo
string
ID of message being replied to.
type_attachments_AttachmentContentId
string
Content ID of attachment.
type__ErrorName
string
Name of error.
type_drafts_DraftSendStatus
string
Schedule send status of draft.
type__ErrorResponse
object
5 properties2 required
type_drafts_DraftUpdatedAt
string
Time at which draft was last updated.
type__ErrorMessage
string
Error message.
type_drafts_DraftItem
object
14 properties4 required
type_drafts_DraftClientId
string
Client ID of draft.
type__PageToken
string
Page token for pagination.
type_drafts_DraftCc
array
Addresses of CC recipients. In format username@domain.com or Display Name .
type_drafts_DraftForwardOf
string
ID of message being forwarded.
type__ErrorCode
string
Stable, machine-readable error code in snakecase (for example, notfound or missingpermission). Branch on this rather than the message text.
type_drafts_DraftLabels
array
Labels of draft.
type__Limit
integer
Limit of number of items returned.
type_drafts_DraftSubject
string
Subject of draft.
type_attachments_AttachmentFilename
string
Filename of attachment.
type__After
string
Timestamp after which to filter by.
type_drafts_DraftAttachments
array
Attachments in draft.
type_attachments_AttachmentResponse
object
8 properties4 required
type_attachments_AttachmentContentDisposition
string
Content disposition of attachment.
type_drafts_DraftHtml
string
HTML body of draft.
type_inboxes_InboxId
string
The ID of the inbox.
type_attachments_AttachmentContentType
string
Content type of attachment.
type_drafts_DraftSendAt
string
Time at which to schedule send draft.
type__Ascending
boolean
Sort in ascending temporal order.
type__ErrorDocs
string
Link to the error reference entry for this code.
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of AgentMail drafts API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
