> ## 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 Comments tools accept.

## Model tree

<div className="model-tree"><div className="model-tree-scroll"><div className="tree-node"><a href="#commentcreatebody">CommentCreateBody</a><div className="tree-children"><div className="tree-node"><a href="#commentattachment">CommentAttachment</a></div><div className="tree-node"><a href="#displayname">DisplayName</a><div className="tree-children"><div className="tree-node"><a href="#customdisplayname">CustomDisplayName</a></div></div></div></div></div><div className="tree-node"><a href="#commentupdatebody">CommentUpdateBody</a></div></div></div>

## CommentCreateBody

The body of a create-comment request.

<div className="reference-table">
  | Field          | Type                                                        | Description                                                                                                                                                                                                                                                      |
  | -------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `parent`       | [Parent](/charter/charter/packs/notion/pages/objects#parent)        | The page or block to comment on, starting a new discussion there.                                                                                                                                                                                                |
  | `discussionId` | `string`                                                    | The ID of an existing discussion to reply to.                                                                                                                                                                                                                    |
  | `richText`     | [RichText](/charter/charter/packs/notion/pages/objects#richtext)\[] | The content of the comment, as rich text. <span className="field-constraints">max 100 items</span>                                                                                                                                                               |
  | `markdown`     | `string`                                                    | The content of the comment as a Markdown string. Comments support inline formatting only — bold, italic, strikethrough, code, links, inline equations and mentions. Fenced code blocks, headings, lists, tables and blockquotes do not become structured blocks. |
  | `attachments`  | [CommentAttachment](#commentattachment)\[]                  | Files to attach. At most three. <span className="field-constraints">max 3 items</span>                                                                                                                                                                           |
  | `displayName`  | [DisplayName](#displayname)                                 | Who the comment appears to be from.                                                                                                                                                                                                                              |
</div>

## CommentAttachment

A file attached to a comment.

<div className="reference-table">
  | Field                                                                | Type     | Description                                         |
  | -------------------------------------------------------------------- | -------- | --------------------------------------------------- |
  | `fileUploadId` <span className="required" title="required">\*</span> | `string` | The ID of a file upload whose status is `uploaded`. |
  | `type`                                                               | `string` | Always `file_upload`.                               |
</div>

## DisplayName

Who the comment appears to be from.

<div className="reference-table">
  | Field                                                        | Type                                    | Description                                                                                                |
  | ------------------------------------------------------------ | --------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
  | `type` <span className="required" title="required">\*</span> | `"integration" \| "user" \| "custom"`   | Whether the comment is attributed to the integration, to the user the token acts for, or to a custom name. |
  | `custom`                                                     | [CustomDisplayName](#customdisplayname) | The custom name, when `type` is `custom`.                                                                  |
</div>

## CustomDisplayName

The name a custom-attributed comment is shown under.

<div className="reference-table">
  | Field                                                        | Type     | Description              |
  | ------------------------------------------------------------ | -------- | ------------------------ |
  | `name` <span className="required" title="required">\*</span> | `string` | The display name to use. |
</div>

## CommentUpdateBody

The body of an update-comment request.

<div className="reference-table">
  | Field      | Type                                                        | Description                                                                                                                                                                                                                                                      |
  | ---------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `richText` | [RichText](/charter/charter/packs/notion/pages/objects#richtext)\[] | The comment's new content, as rich text. <span className="field-constraints">max 100 items</span>                                                                                                                                                                |
  | `markdown` | `string`                                                    | The content of the comment as a Markdown string. Comments support inline formatting only — bold, italic, strikethrough, code, links, inline equations and mentions. Fenced code blocks, headings, lists, tables and blockquotes do not become structured blocks. |
</div>