> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# Objects

> Every object and enum the Message tools accept.

## Model tree

<div className="model-tree"><div className="model-tree-scroll"><div className="tree-node"><a href="#message">Message</a></div><div className="tree-node"><a href="#modifymessagerequest">ModifyMessageRequest</a></div><div className="tree-node"><a href="#batchmodifymessagesrequest">BatchModifyMessagesRequest</a></div></div></div>

## Message

An email message.

<div className="reference-table">
  | Field                                                       | Type                                                                                                                                                                                        | Description                                                                                                                                                                                                                                                                                                                                                          |
  | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `threadId`                                                  | `string`                                                                                                                                                                                    | The ID of the thread the message belongs to. To add a message or draft to a thread, the following criteria must be met: 1. The requested threadId must be specified on the Message or Draft.Message you supply with your request. 2. The References and In-Reply-To headers must be set in compliance with the RFC 2822 standard. 3. The Subject headers must match. |
  | `raw` <span className="required" title="required">\*</span> | `EmailContent`<br /><span className="markers"><span className="marker" data-marker="transform">rfc822\_base64</span><span className="marker" data-marker="mode">request\_only</span></span> | Email message content                                                                                                                                                                                                                                                                                                                                                |
</div>

## ModifyMessageRequest

Request body for Gmail `users.messages.modify` endpoint.

<div className="reference-table">
  | Field            | Type        | Description                                                                                                                                                     |
  | ---------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `addLabelIds`    | `string`\[] | A list of IDs of labels to add to this message. You can add up to 100 labels with each update. <span className="field-constraints">max 100 items</span>         |
  | `removeLabelIds` | `string`\[] | A list of IDs of labels to remove from this message. You can remove up to 100 labels with each update. <span className="field-constraints">max 100 items</span> |
</div>

## BatchModifyMessagesRequest

Request body for Gmail `users.messages.batchModify` endpoint.

<div className="reference-table">
  | Field                                                       | Type        | Description                                                                                                                            |
  | ----------------------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------- |
  | `ids` <span className="required" title="required">\*</span> | `string`\[] | The IDs of the messages to modify. There is a limit of 1000 ids per request. <span className="field-constraints">max 1000 items</span> |
  | `addLabelIds`                                               | `string`\[] | A list of label IDs to add to messages.                                                                                                |
  | `removeLabelIds`                                            | `string`\[] | A list of label IDs to remove from messages.                                                                                           |
</div>

## MessageFormat

<div className="enum-table">
  | Value      |
  | ---------- |
  | `minimal`  |
  | `full`     |
  | `raw`      |
  | `metadata` |
</div>