Actions30
- Message Actions
- Label Actions
- Draft Actions
- Thread Actions
Draft → Delete a Draft
AI-generatedSummary
Delete a draft by ID
Inputs
- draftId (required) — ID of the draft to delete.
- fetchOptions — Optional fetch settings such as search, read status, include body values, download attachments, etc.
- debug — Enable debug output to include raw JMAP responses.
- includeBodyValues — Include full body values in the response when set to true.
- downloadAttachments — Download message attachments into binary output when set to true.
- attachmentBinaryPrefix — Prefix used for binary property names when downloading attachments.
- search — Simple full-text search string for querying drafts.
Output shape
a single record indicating deletion success and the draft ID
The
successfulfield reflects whether the deletion succeeded; debug output may include before/after state.
Examples
Example 1: Delete a specific draft
Set Draft ID to the target draft's ID; optionally enable Include Body Values or Debug.
Example 2: Delete drafts matching a search query
Provide a Search term in Fetch Options; optionally set Read Status; the operation will delete each matching draft.
Example 3: Delete a draft with debug output
Enable Debug flag to receive raw JMAP responses for troubleshooting.