get_emails_content
Retrieve the full content and body of emails using their IDs, with options for paginated reading of long messages.
Instructions
Get the full content (including body) of one or more emails by their email_id. Use list_emails_metadata first to get the email_id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mailbox | No | The mailbox to retrieve emails from. | INBOX |
| email_ids | Yes | List of email_id to retrieve (obtained from list_emails_metadata). Can be a single email_id or multiple email_ids. | |
| body_offset | No | Character offset into each email body to start reading from. Use together with max_body_length to page through long emails: if a returned body ends with the '...[TRUNCATED]' marker, fetch the next chunk with body_offset += max_body_length. | |
| account_name | Yes | The name of the email account. | |
| mark_as_read | No | If True, mark each successfully retrieved email as read. If marking fails, a warning is logged and retrieval still succeeds. | |
| max_body_length | No | Maximum number of body characters to return, counted from body_offset. If the body extends past this window, the '...[TRUNCATED]' marker is appended after the requested body window. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| emails | Yes | ||
| failed_ids | Yes | ||
| requested_count | Yes | ||
| retrieved_count | Yes |