Skip to main content
GET
List All Drafts
Lists unsent drafts across every inbox in the account. Returns count, limit, next_page_token and drafts; page with next_page_token. Each draft carries draft_id, inbox_id, to, cc, bcc, subject, preview, attachments, send_status and send_at. List items carry preview only — text and html come from get_agentmail_draft. This is the organization-wide view spanning every inbox in the account. Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created; the inbox-scoped twin get_agentmail_inbox_drafts is the one to use when a single inbox is meant.

Example

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Authorization
string
required

Bearer authentication

Query Parameters

limit
integer

Limit of number of items returned.

page_token
string

Page token for pagination.

labels
string[]

Labels to filter by.

before
string<date-time>

Timestamp before which to filter by.

after
string<date-time>

Timestamp after which to filter by.

ascending
boolean

Sort in ascending temporal order.

Response

Response with status 200

count
integer
required

Number of items returned.

drafts
DraftItem · object[]
required

Ordered by updated_at descending.

limit
integer

Limit of number of items returned.

next_page_token
string

Page token for pagination.