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
subjectstring

Subject line

Subject line

plainTextBodystring

Plain text body (optional fallback)

Plain text body (optional fallback)

toRecipientsarray of EmailRecipientDto

To recipients — the draft's full To list

To recipients — the draft's full To list

ccRecipientsarray of EmailRecipientDto

CC recipients — the draft's full CC list

CC recipients — the draft's full CC list

bccRecipientsarray of EmailRecipientDto

BCC recipients — the draft's full BCC list

BCC recipients — the draft's full BCC list

attachmentsarray 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.

keepAttachmentIdsarray 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.

htmlBody*string

HTML body of the draft. Redeclared from the email service contract so it is cleaned as the request is read.

HTML body of the draft. Redeclared from the email service contract so it is cleaned as the request is read.

practiceDocumentCodesarray 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",
  "plainTextBody": "string",
  "toRecipients": [
    {
      "email": "...",
      "name": "..."
    }
  ],
  "ccRecipients": [
    {
      "email": "...",
      "name": "..."
    }
  ],
  "bccRecipients": [
    {
      "email": "...",
      "name": "..."
    }
  ],
  "htmlBody": "string"
}

Used By Operations