# openemail.labels

Folders and labels: create, rename and delete them, update every message in one, and the IMAP-shaped UID and vanished feeds a mail client syncs from.

Its 12 methods, each a page of its own, in the order the API reference presents them:

| Method | What it does | It calls |
| --- | --- | --- |
| [`labels.create`](/docs/sdks/typescript/labels/create) | Create a new custom label | [`POST /mailboxes/{mailboxId}/labels`](/docs/api/labels/post_LabelCreate) |
| [`labels.list`](/docs/sdks/typescript/labels/list) | List mailbox labels and folder statistics | [`GET /mailboxes/{mailboxId}/labels`](/docs/api/labels/get_LabelList) |
| [`labels.update`](/docs/sdks/typescript/labels/update) | Rename a label or update folder settings | [`PATCH /mailboxes/{mailboxId}/labels/{label}`](/docs/api/labels/patch_LabelRename) |
| [`labels.updateById`](/docs/sdks/typescript/labels/update-by-id) | Rename a label or update folder settings, by id | [`PATCH /mailboxes/{mailboxId}/labels/by-id/{labelId}`](/docs/api/labels/patch_LabelRenameById) |
| [`labels.delete`](/docs/sdks/typescript/labels/delete) | Delete a custom label | [`DELETE /mailboxes/{mailboxId}/labels/{label}`](/docs/api/labels/delete_LabelDelete) |
| [`labels.deleteById`](/docs/sdks/typescript/labels/delete-by-id) | Delete a custom label, by id | [`DELETE /mailboxes/{mailboxId}/labels/by-id/{labelId}`](/docs/api/labels/delete_LabelDeleteById) |
| [`labels.listMessages`](/docs/sdks/typescript/labels/list-messages) | List messages in a label by UID | [`GET /mailboxes/{mailboxId}/labels/{label}/messages`](/docs/api/labels/get_LabelMessageList) |
| [`labels.updateMessages`](/docs/sdks/typescript/labels/update-messages) | Update flags, labels and keywords for every message in a folder | [`PATCH /mailboxes/{mailboxId}/labels/{label}/messages`](/docs/api/labels/patch_LabelMessagesUpdate) |
| [`labels.updateMessagesById`](/docs/sdks/typescript/labels/update-messages-by-id) | Update flags, labels and keywords for every message in a folder, by label id | [`PATCH /mailboxes/{mailboxId}/labels/by-id/{labelId}/messages`](/docs/api/labels/patch_LabelMessagesUpdateById) |
| [`labels.listUids`](/docs/sdks/typescript/labels/list-uids) | List message sync index for a label | [`GET /mailboxes/{mailboxId}/labels/{label}/uids`](/docs/api/labels/get_LabelUidList) |
| [`labels.listVanished`](/docs/sdks/typescript/labels/list-vanished) | List vanished (expunged) message UIDs | [`GET /mailboxes/{mailboxId}/labels/{label}/vanished`](/docs/api/labels/get_LabelVanished) |
| [`labels.expunge`](/docs/sdks/typescript/labels/expunge) | Expunge deleted messages from a label | [`POST /mailboxes/{mailboxId}/labels/{label}/expunge`](/docs/api/labels/post_LabelExpunge) |

In the API reference: [Labels](/docs/api/labels).
