{"uid":"cap__MdUMaKpRrzG9sVYL0EQl","slug":"agentmail-f71a188d","name":"AgentMail List Drafts","description":"List Drafts","url":"https://x402.api.agentmail.to/v0/drafts","method":"GET","headers":{},"bodySchema":{"type":"object","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."},"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":["x402"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","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":{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_G_IEP3URZlx7YyShrOVEV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the list of email drafts stored in the AgentMail system for the authenticated agent","exampleAgentPrompt":"Show me all the email drafts saved in my AgentMail account so I can review what's pending before sending.","exampleUseCases":null,"resultDescription":"Returns a list of email draft objects, each containing draft metadata such as draft ID, recipient(s), subject, body content, creation timestamp, and associated inbox or thread information.","failureModes":["401 Unauthorized if authentication token is invalid or missing","403 Forbidden if agent lacks permission to access drafts","404 Not Found if no drafts exist or the organization is not found","500 Internal Server Error if the AgentMail service is unavailable","Empty list returned if no drafts have been saved"],"whenToPreferThis":"Use this endpoint when an AI agent needs to inspect, review, or enumerate unsent email drafts before sending them, editing them, or auditing communication state. Prefer this over List Threads when you specifically want drafts (not sent/received messages) and over List Inboxes when you want the draft content rather than inbox configuration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:47:46.394Z","isFirstParty":false}