UpdateMailboxDraftRequest

Request to update a mailbox draft, extending the email service contract with references to
existing draft attachments to keep unchanged. Resolved to content server-side so the browser
never has to re-download and re-upload bytes for attachments the user didn't touch.

Properties

Name	Type	Description
subject	string	Subject line
Subject line
htmlBody*	string	HTML body of the draft
HTML body of the draft
plainTextBody	string	Plain text body (optional fallback)
Plain text body (optional fallback)
toRecipients	array of EmailRecipientDto	To recipients — the draft's full To list
To recipients — the draft's full To list
ccRecipients	array of EmailRecipientDto	CC recipients — the draft's full CC list
CC recipients — the draft's full CC list
bccRecipients	array of EmailRecipientDto	BCC recipients — the draft's full BCC list
BCC recipients — the draft's full BCC list
attachments	array of EmailAttachmentDto	Attachments the saved draft should have. Null = leave the draft's existing attachments untouched (no attachment changes made in this edit). Empty list = remove every attachment. A populated list replaces the attachment set outright.
Attachments the saved draft should have. Null = leave the draft's existing attachments untouched (no attachment changes made in this edit). Empty list = remove every attachment. A populated list replaces the attachment set outright.
keepAttachmentIds	array of string	Ids (from the draft's current attachment list) of existing attachments to keep. Only consulted when the edit changes attachments at all — omit both this and Attachments to leave every existing attachment untouched.
Ids (from the draft's current attachment list) of existing attachments to keep. Only consulted when the edit changes attachments at all — omit both this and Attachments to leave every existing attachment untouched.
practiceDocumentCodes	array of string	Codes of practice documents (tenant document library) to attach. Resolved to file content server-side, same as create and send.
Codes of practice documents (tenant document library) to attach. Resolved to file content server-side, same as create and send.

JSON Example

{
  "subject": "string",
  "htmlBody": "string",
  "plainTextBody": "string",
  "toRecipients": [
    {
      "email": "...",
      "name": "..."
    }
  ],
  "ccRecipients": [
    {
      "email": "...",
      "name": "..."
    }
  ]
}

Used By Operations

PATCH Update Draft
/tenants/{tenant}/email-configs/{code}/drafts/{messageId}