{"uid":"cap_UsQjXJHJNP3dFPdb45U1c","slug":"agentmail-drafts-c5b907c3","name":"AgentMail List Drafts","description":"List Drafts","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/drafts?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["pod_id"],"properties":{"after":{"type":"string","title":"After","format":"date-time","description":"Timestamp after which to filter by."},"limit":{"type":"integer","title":"Limit","description":"Limit of number of items returned."},"before":{"type":"string","title":"Before","format":"date-time","description":"Timestamp before which to filter by."},"labels":{"type":"array","items":{"type":"string"},"title":"Labels","description":"Labels to filter by."},"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"ascending":{"type":"boolean","title":"Ascending","description":"Sort in ascending temporal order."},"page_token":{"type":"string","title":"PageToken","description":"Page token for pagination."}}},"responseSchema":{"type":"object","title":"ListDraftsResponse","required":["count","drafts"],"properties":{"count":{"type":"integer","title":"Count","description":"Number of items returned."},"limit":{"type":"integer","title":"Limit","description":"Limit of number of items returned."},"drafts":{"type":"array","items":{"type":"object","title":"DraftItem","required":["inbox_id","draft_id","labels","updated_at"],"properties":{"cc":{"type":"array","items":{"type":"string"},"title":"DraftCc","description":"Addresses of CC recipients. In format `username@domain.com` or `Display Name <username@domain.com>`."},"to":{"type":"array","items":{"type":"string"},"title":"DraftTo","description":"Addresses of recipients. In format `username@domain.com` or `Display Name <username@domain.com>`."},"bcc":{"type":"array","items":{"type":"string"},"title":"DraftBcc","description":"Addresses of BCC recipients. In format `username@domain.com` or `Display Name <username@domain.com>`."},"labels":{"type":"array","items":{"type":"string"},"title":"DraftLabels","description":"Labels of draft."},"preview":{"type":"string","title":"DraftPreview","description":"Text preview of draft."},"send_at":{"type":"string","title":"DraftSendAt","format":"date-time","description":"Time at which to schedule send draft."},"subject":{"type":"string","title":"DraftSubject","description":"Subject of draft."},"draft_id":{"type":"string","title":"DraftId","description":"ID of draft."},"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."},"updated_at":{"type":"string","title":"DraftUpdatedAt","format":"date-time","description":"Time at which draft was last updated."},"attachments":{"type":"array","items":{"type":"object","title":"Attachment","required":["attachment_id","size"],"properties":{"size":{"$ref":"#/components/schemas/type_attachments:AttachmentSize"},"filename":{"$ref":"#/components/schemas/type_attachments:AttachmentFilename"},"content_id":{"$ref":"#/components/schemas/type_attachments:AttachmentContentId"},"content_type":{"$ref":"#/components/schemas/type_attachments:AttachmentContentType"},"attachment_id":{"$ref":"#/components/schemas/type_attachments:AttachmentId"},"content_disposition":{"$ref":"#/components/schemas/type_attachments:AttachmentContentDisposition"}}},"title":"DraftAttachments","description":"Attachments in draft."},"in_reply_to":{"type":"string","title":"DraftInReplyTo","description":"ID of message being replied to."},"send_status":{"enum":["scheduled","sending","failed"],"type":"string","title":"DraftSendStatus","description":"Schedule send status of draft."}}},"description":"Ordered by `updated_at` descending."},"next_page_token":{"type":"string","title":"PageToken","description":"Page token for pagination."}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"free_handshake","priceSource":"unknown","requiresHandshake":true,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"free · handshake required","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Lists all email drafts within a specified AgentMail pod, with filtering and pagination support","exampleAgentPrompt":"Show me all the email drafts in my AgentMail pod 'pod_abc123' — give me the 20 most recent ones, filtered to only those with the label 'outreach'.","exampleUseCases":[{"title":"Review scheduled outreach emails before sending","prompt":"Can you pull up all the draft emails in my 'sales_team' pod that are scheduled to send? I want to review them before they go out to make sure everything looks good."},{"title":"Audit unsent emails by label and date","prompt":"Show me the pending drafts in my 'pod_customer_support' that have the 'urgent_reply' label from the last 7 days. I need to see what follow-ups are queued up."},{"title":"Monitor draft queue across team mailbox","prompt":"Give me a count of all the unsent drafts currently sitting in our 'pod_marketing' inbox. I want to know how many emails are waiting to be sent and what the oldest one is."}],"resultDescription":"Returns a paginated list of draft objects for the specified pod, each including draft_id, inbox_id, subject, to/cc/bcc recipients, preview text, labels, scheduled send time, last updated timestamp, and attachment metadata, along with total count and pagination token.","failureModes":["Invalid or missing pod_id returns 404 not found","Invalid Authorization token returns 401 unauthorized","Malformed date-time format for before/after returns 422 validation error","Invalid page_token returns 400 bad request","Pod with no drafts returns empty drafts array with count 0"],"whenToPreferThis":"Use this endpoint when you need to inspect, audit, or enumerate unsent email drafts managed by an AI agent within an AgentMail pod. Prefer this over thread or message listing endpoints when you specifically want draft (unsent) content. Best for agents that manage outbound email queues, review scheduled sends, or need to check draft state before sending.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-05-27T17:47:21.099Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:37:55.573Z","isFirstParty":false,"canonicalSlug":"agentmail-drafts-c525e332"}