publ betaReference (MCP guide)
Open publ console

publ Reference

email_draft_labels_apply

Replace the labels of one email in the Email app (pApp F00003), in any status as on the console detail screen. Requires existing label IDs (empty clears). Write; content and recipients are kept. A lost receipt stays pending and is never resent; task_resume only observes, and prepared work needs the identical apply. Called without confirmToken it previews and returns a confirmToken; repeating the same input with it executes once.

Inputs

Field Required here Contract
settings Yes object
settings.labelIds Yes array; items: string; pattern ^[A-Za-z0-9_-]{1,200}$; Exact email identifier returned by email_drafts_get.; max items 20; Complete replacement set of existing labels. Empty clears all labels. Emails in any status (DRAFT, SCHEDULE, PENDING, SENT) can change labels, as on the console detail page; labels do not change what is sent.
emailId Yes string; pattern ^[A-Za-z0-9_-]{1,200}$; Exact email identifier returned by email_drafts_get.
confirmToken No string; pattern ^ct[a-f\d]{32}$; The confirmToken from this tool's preview result. Omit it to preview; repeat the same input with it to execute.