email_draft_labels_apply

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