{"uid":"cap_dlV-OhMi28F8awllRb9W-","slug":"agentmail-drafts-c525e332","name":"AgentMail List Drafts","description":"List Drafts","url":"https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/drafts?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["inbox_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."},"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."},"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":"unprobed","priceSource":"unknown","requiresHandshake":false,"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","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Lists all email drafts in a specified AgentMail inbox, with support for filtering, pagination, and sorting","exampleAgentPrompt":"Show me all the drafts saved in AgentMail inbox 'inbox_abc123' — up to 20 of them, filtered to those labeled 'follow-up', sorted from newest to oldest.","exampleUseCases":null,"resultDescription":"Returns a paginated list of draft objects for the specified inbox, each containing draft_id, inbox_id, subject, to/cc/bcc recipients, preview text, labels, scheduled send time, attachments metadata, and last updated timestamp, along with a count of items returned and pagination limit.","failureModes":["Invalid or missing inbox_id returns 404 not found","Expired or invalid Bearer token returns 401 unauthorized","Invalid date-time format for before/after filters returns 400 bad request","Non-existent label filter returns empty drafts array with count 0","Invalid page_token returns 400 or empty results","Rate limiting may return 429 too many requests"],"whenToPreferThis":"Use this endpoint when an AI agent needs to inspect, review, or manage unsent email drafts within a specific AgentMail inbox — especially useful for automation workflows that check pending outbound messages, retrieve scheduled drafts, or audit draft content before sending. Prefer this over a general email list endpoint when specifically targeting draft state rather than sent or received messages.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:21.881Z","isFirstParty":false,"canonicalSlug":"agentmail-drafts-c525e332"}