{"uid":"cap_BCvNH0JhGEp4kKwKIcGSG","slug":"agentmail-draft-id-9aa462ca","name":"AgentMail Update Draft","description":"Update Draft","url":"https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/drafts/:draft_id?utm_source=zero.xyz","method":"PATCH","headers":{},"bodySchema":{"type":"object","title":"UpdateDraftRequest","properties":{"cc":{"type":"array","items":{"type":"string"},"title":"DraftCc","description":"Addresses of CC recipients. In format `username@domain.com` or `Display Name `."},"to":{"type":"array","items":{"type":"string"},"title":"DraftTo","description":"Addresses of recipients. In format `username@domain.com` or `Display Name `."},"bcc":{"type":"array","items":{"type":"string"},"title":"DraftBcc","description":"Addresses of BCC recipients. In format `username@domain.com` or `Display Name `."},"html":{"type":"string","title":"DraftHtml","description":"HTML body of draft."},"text":{"type":"string","title":"DraftText","description":"Plain text body 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."},"reply_to":{"type":"array","items":{"type":"string"},"title":"DraftReplyTo","description":"Reply-to addresses. In format `username@domain.com` or `Display Name `."}}},"responseSchema":{"type":"object","title":"Draft","required":["inbox_id","draft_id","labels","updated_at","created_at"],"properties":{"cc":{"type":"array","items":{"type":"string"},"title":"DraftCc","description":"Addresses of CC recipients. In format `username@domain.com` or `Display Name `."},"to":{"type":"array","items":{"type":"string"},"title":"DraftTo","description":"Addresses of recipients. In format `username@domain.com` or `Display Name `."},"bcc":{"type":"array","items":{"type":"string"},"title":"DraftBcc","description":"Addresses of BCC recipients. In format `username@domain.com` or `Display Name `."},"html":{"type":"string","title":"DraftHtml","description":"HTML body of draft."},"text":{"type":"string","title":"DraftText","description":"Plain text body of draft."},"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."},"reply_to":{"type":"array","items":{"type":"string"},"title":"DraftReplyTo","description":"Reply-to addresses. In format `username@domain.com` or `Display Name `."},"client_id":{"type":"string","title":"DraftClientId","description":"Client ID of draft."},"created_at":{"type":"string","format":"date-time","description":"Time at which draft was created."},"references":{"type":"array","items":{"type":"string"},"description":"IDs of previous messages in thread."},"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":{"type":"integer","title":"AttachmentSize","description":"Size of attachment in bytes."},"filename":{"type":"string","title":"AttachmentFilename","description":"Filename of attachment."},"content_id":{"type":"string","title":"AttachmentContentId","description":"Content ID of attachment."},"content_type":{"type":"string","title":"AttachmentContentType","description":"Content type of attachment."},"attachment_id":{"type":"string","title":"AttachmentId","description":"ID of attachment."},"content_disposition":{"enum":["inline","attachment"],"type":"string","title":"AttachmentContentDisposition","description":"Content disposition of attachment."}}},"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."}}},"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":"Updates an existing email draft in an AgentMail inbox, allowing modifications to recipients, subject, body, scheduling, and other fields","exampleAgentPrompt":"Update my draft 'draft_abc123' in inbox 'inbox_xyz456' on AgentMail — change the subject to 'Meeting Follow-Up', update the body text to 'Hi, just following up on our meeting. Let me know your thoughts.', and schedule it to send at 2025-06-01T09:00:00Z.","exampleUseCases":null,"resultDescription":"Returns the full updated Draft object including draft_id, inbox_id, to, cc, bcc, subject, html, text, reply_to, labels, preview, send_at, client_id, references, created_at, and updated_at timestamps.","failureModes":["404 if inbox_id or draft_id does not exist","401 if Bearer token is missing or invalid","400 if request body fields are malformed (e.g. invalid email address format or invalid date-time for send_at)","422 if required path parameters inbox_id or draft_id are not provided","409 if draft has already been sent and cannot be modified"],"whenToPreferThis":"Use this endpoint when an AI agent needs to revise an already-created email draft before sending — such as updating recipient lists, changing subject or body content, or adjusting a scheduled send time. Prefer this over creating a new draft when an existing draft_id is known and only partial fields need modification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:38:52.644Z","isFirstParty":false,"canonicalSlug":"agentmail-draft-id-9aa462ca"}