# openemail.messages

The message store: list and read messages (metadata, parsed content, raw MIME, parts), update and delete them one by one or in batches, append, compose and…

The message store: list and read messages (metadata, parsed content, raw MIME, parts), update and delete them one by one or in batches, append, compose and copy them, restore them, train the spam filter, follow the changes feed, and send.

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

| Method | What it does | It calls |
| --- | --- | --- |
| [`messages.list`](/docs/sdks/typescript/messages/list) | List mailbox messages | [`GET /mailboxes/{mailboxId}/messages`](/docs/api/messages/get_MessageList) |
| [`messages.get`](/docs/sdks/typescript/messages/get) | Get message metadata | [`GET /mailboxes/{mailboxId}/messages/{messageId}`](/docs/api/messages/get_MessageGet) |
| [`messages.getMany`](/docs/sdks/typescript/messages/get-many) | Batch get message metadata | [`POST /mailboxes/{mailboxId}/messages/batch`](/docs/api/messages/post_MessageBatchGet) |
| [`messages.getContent`](/docs/sdks/typescript/messages/get-content) | Get parsed message content and attachments | [`GET /mailboxes/{mailboxId}/messages/{messageId}/content`](/docs/api/messages/get_MessageGetContent) |
| [`messages.getRaw`](/docs/sdks/typescript/messages/get-raw) | Get raw MIME message body | [`GET /mailboxes/{mailboxId}/messages/{messageId}/raw`](/docs/api/messages/get_MessageGetRaw) |
| [`messages.getPart`](/docs/sdks/typescript/messages/get-part) | Get specific message MIME part | [`GET /mailboxes/{mailboxId}/messages/{messageId}/parts/{section}`](/docs/api/messages/get_MessageGetPart) |
| [`messages.getRawHeaders`](/docs/sdks/typescript/messages/get-raw-headers) | Batch get raw header blocks | [`POST /mailboxes/{mailboxId}/messages/heads`](/docs/api/messages/post_MessageHeadBatch) |
| [`messages.getMimeStructures`](/docs/sdks/typescript/messages/get-mime-structures) | Batch get cached MIME structures | [`POST /mailboxes/{mailboxId}/messages/mime`](/docs/api/messages/post_MessageMimeBatch) |
| [`messages.update`](/docs/sdks/typescript/messages/update) | Update message flags and labels | [`PATCH /mailboxes/{mailboxId}/messages/{messageId}`](/docs/api/messages/patch_MessageUpdate) |
| [`messages.updateMany`](/docs/sdks/typescript/messages/update-many) | Update flags and labels for multiple messages or whole conversations | [`PATCH /mailboxes/{mailboxId}/messages`](/docs/api/messages/patch_MessageBatchUpdate) |
| [`messages.delete`](/docs/sdks/typescript/messages/delete) | Delete a message | [`DELETE /mailboxes/{mailboxId}/messages/{messageId}`](/docs/api/messages/delete_MessageDelete) |
| [`messages.deleteMany`](/docs/sdks/typescript/messages/delete-many) | Empty trash, or delete a batch of messages or whole conversations | [`DELETE /mailboxes/{mailboxId}/messages`](/docs/api/messages/delete_MessageEmptyTrash) |
| [`messages.append`](/docs/sdks/typescript/messages/append) | Append raw MIME message to mailbox | [`POST /mailboxes/{mailboxId}/messages`](/docs/api/messages/post_MessageAppend) |
| [`messages.compose`](/docs/sdks/typescript/messages/compose) | Save structured message to mailbox | [`POST /mailboxes/{mailboxId}/messages/compose`](/docs/api/messages/post_MessageCompose) |
| [`messages.copy`](/docs/sdks/typescript/messages/copy) | Copy or move messages and conversations into another mailbox | [`POST /mailboxes/{mailboxId}/messages/copy`](/docs/api/messages/post_MessageCopy) |
| [`messages.restore`](/docs/sdks/typescript/messages/restore) | Restore an expunged message from trash | [`POST /mailboxes/{mailboxId}/messages/{messageId}/restore`](/docs/api/messages/post_MessageRestore) |
| [`messages.restoreMany`](/docs/sdks/typescript/messages/restore-many) | Restore multiple messages from trash | [`POST /mailboxes/{mailboxId}/messages/restore`](/docs/api/messages/post_MessageBatchRestore) |
| [`messages.untrash`](/docs/sdks/typescript/messages/untrash) | Take messages out of Trash, back to where they were filed | [`POST /mailboxes/{mailboxId}/messages/untrash`](/docs/api/messages/post_MessageBatchUntrash) |
| [`messages.unjunk`](/docs/sdks/typescript/messages/unjunk) | Take messages out of Junk, back to where they were filed | [`POST /mailboxes/{mailboxId}/messages/unjunk`](/docs/api/messages/post_MessageBatchUnjunk) |
| [`messages.learn`](/docs/sdks/typescript/messages/learn) | Train spam filter from a message | [`POST /mailboxes/{mailboxId}/messages/{messageId}/learn`](/docs/api/messages/post_MessageLearn) |
| [`messages.learnMany`](/docs/sdks/typescript/messages/learn-many) | Train spam filter from multiple messages | [`POST /mailboxes/{mailboxId}/messages/learn`](/docs/api/messages/post_MessageBatchLearn) |
| [`messages.listKeywords`](/docs/sdks/typescript/messages/list-keywords) | List the keywords in use, with counts | [`GET /mailboxes/{mailboxId}/keywords`](/docs/api/messages/get_MailboxKeywordList) |
| [`messages.getChanges`](/docs/sdks/typescript/messages/get-changes) | Get message sync changes | [`GET /mailboxes/{mailboxId}/messages/changes`](/docs/api/messages/get_MessageChanges) |
| [`messages.send`](/docs/sdks/typescript/messages/send) | Send an email message | [`POST /mailboxes/{mailboxId}/send`](/docs/api/delivery/post_MessageSend) |
| [`messages.sendDraft`](/docs/sdks/typescript/messages/send-draft) | Send a stored draft | [`POST /mailboxes/{mailboxId}/messages/{messageId}/submit`](/docs/api/delivery/post_MessageSubmit) |
| [`messages.getDelivery`](/docs/sdks/typescript/messages/get-delivery) | Get delivery status of a sent message | [`GET /mailboxes/{mailboxId}/messages/{messageId}/delivery`](/docs/api/delivery/get_MessageDeliveryGet) |
| [`messages.getInvitation`](/docs/sdks/typescript/messages/get-invitation) | Get invitation from email message | [`GET /mailboxes/{mailboxId}/messages/{messageId}/invitation`](/docs/api/pim/get_MessageInvitationRoute) |

In the API reference: [Messages](/docs/api/messages), [Delivery](/docs/api/delivery), [PIM](/docs/api/pim).
