> ## 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="#commentslistvariables">CommentsListVariables</a><div className="tree-children"><div className="tree-node"><a href="#commentfilter">CommentFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullableissuefilter">NullableIssueFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullableissuefilter">NullableIssueFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nullableprojectupdatefilter">NullableProjectUpdateFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullableprojectupdatefilter">NullableProjectUpdateFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nullableinitiativeupdatefilter">NullableInitiativeUpdateFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullableinitiativeupdatefilter">NullableInitiativeUpdateFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nullabledocumentcontentfilter">NullableDocumentContentFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullabledocumentcontentfilter">NullableDocumentContentFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#commentfilter">CommentFilter</a> <span className="tree-note">above</span></div></div></div></div></div><div className="tree-node"><a href="#commentgetvariables">CommentGetVariables</a></div><div className="tree-node"><a href="#commentcreatevariables">CommentCreateVariables</a><div className="tree-children"><div className="tree-node"><a href="#commentcreateinput">CommentCreateInput</a></div></div></div><div className="tree-node"><a href="#commentupdatevariables">CommentUpdateVariables</a><div className="tree-children"><div className="tree-node"><a href="#commentupdateinput">CommentUpdateInput</a></div></div></div><div className="tree-node"><a href="#commentdeletevariables">CommentDeleteVariables</a></div><div className="tree-node"><a href="#commentresolvevariables">CommentResolveVariables</a></div><div className="tree-node"><a href="#commentunresolvevariables">CommentUnresolveVariables</a></div><div className="tree-node"><a href="#reactioncreatevariables">ReactionCreateVariables</a><div className="tree-children"><div className="tree-node"><a href="#reactioncreateinput">ReactionCreateInput</a></div></div></div><div className="tree-node"><a href="#reactiondeletevariables">ReactionDeleteVariables</a></div></div></div>

## CommentsListVariables

Variables for the `comments` connection.

<div className="reference-table">
  | Field             | Type                            | Description                                                                                                                       |
  | ----------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
  | `first`           | `integer`                       | How many results to return. Linear returns 50 by default. <span className="field-constraints">≥ 1; ≤ 250; defaults to `50`</span> |
  | `after`           | `string`                        | The `endCursor` from the previous page's `pageInfo`, to fetch the next page.                                                      |
  | `filter`          | [CommentFilter](#commentfilter) | Narrow the comments returned. To read one issue's thread, filter on `issue.id.eq` with the issue's UUID.                          |
  | `includeArchived` | `boolean`                       | Include comments on archived issues.                                                                                              |
</div>

## CommentFilter

A filter over comments. Conditions combine with AND.

<div className="reference-table">
  | Field              | Type                                                                                | Description                                                                                                 |
  | ------------------ | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
  | `id`               | [IdComparator](/charter/charter/packs/linear/workspace/objects#idcomparator)                | Filter by comment UUID.                                                                                     |
  | `body`             | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)        | Match on the comment's text.                                                                                |
  | `createdAt`        | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)            | Filter by when the comment was posted.                                                                      |
  | `updatedAt`        | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)            | Filter by when the comment was last edited.                                                                 |
  | `user`             | [UserFilter](/charter/charter/packs/linear/workspace/objects#userfilter)                    | Filter by who wrote the comment.                                                                            |
  | `issue`            | [NullableIssueFilter](#nullableissuefilter)                                         | Filter by the issue the comment is on. To read one issue's thread, use `issue.id.eq` with the issue's UUID. |
  | `project`          | [NullableProjectFilter](/charter/charter/packs/linear/issues/objects#nullableprojectfilter) | Filter by the project the comment is on.                                                                    |
  | `projectUpdate`    | [NullableProjectUpdateFilter](#nullableprojectupdatefilter)                         | Filters that the comment's project update must satisfy.                                                     |
  | `initiativeUpdate` | [NullableInitiativeUpdateFilter](#nullableinitiativeupdatefilter)                   | Filters that the comment's initiative update must satisfy.                                                  |
  | `documentContent`  | [NullableDocumentContentFilter](#nullabledocumentcontentfilter)                     | Filters that the comment's document content must satisfy.                                                   |
</div>

## NullableIssueFilter

IssueFilter that can also match an unset relation.

<div className="reference-table">
  | Field    | Type                                                                         | Description                       |
  | -------- | ---------------------------------------------------------------------------- | --------------------------------- |
  | `id`     | [IdComparator](/charter/charter/packs/linear/workspace/objects#idcomparator)         | Comparator for the identifier.    |
  | `number` | [NumberComparator](/charter/charter/packs/linear/workspace/objects#numbercomparator) | Comparator for the issues number. |
  | `title`  | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator) | Comparator for the issues title.  |
</div>

## NullableProjectUpdateFilter

ProjectUpdateFilter that can also match an unset relation.

<div className="reference-table">
  | Field | Type                                                                 | Description            |
  | ----- | -------------------------------------------------------------------- | ---------------------- |
  | `id`  | [IdComparator](/charter/charter/packs/linear/workspace/objects#idcomparator) | Filter by update UUID. |
</div>

## NullableInitiativeUpdateFilter

A filter over initiative status updates that may be unset.

<div className="reference-table">
  | Field | Type                                                                 | Description                    |
  | ----- | -------------------------------------------------------------------- | ------------------------------ |
  | `id`  | [IdComparator](/charter/charter/packs/linear/workspace/objects#idcomparator) | Comparator for the identifier. |
</div>

## NullableDocumentContentFilter

DocumentContentFilter that can also match an unset relation.

<div className="reference-table">
  | Field | Type                                                                 | Description                    |
  | ----- | -------------------------------------------------------------------- | ------------------------------ |
  | `id`  | [IdComparator](/charter/charter/packs/linear/workspace/objects#idcomparator) | Comparator for the identifier. |
</div>

## CommentGetVariables

Variables for the `comment` query.

<div className="reference-table">
  | Field  | Type     | Description                                                |
  | ------ | -------- | ---------------------------------------------------------- |
  | `id`   | `string` | The comment's UUID.                                        |
  | `hash` | `string` | The comment's hash, as it appears in a Linear comment URL. |
</div>

## CommentCreateVariables

Variables for the `commentCreate` mutation.

<div className="reference-table">
  | Field                                                         | Type                                      | Description          |
  | ------------------------------------------------------------- | ----------------------------------------- | -------------------- |
  | `input` <span className="required" title="required">\*</span> | [CommentCreateInput](#commentcreateinput) | The comment to post. |
</div>

## CommentCreateInput

The input to `commentCreate`.

<div className="reference-table">
  | Field                                                        | Type        | Description                                                                                                                                                                                                                                             |
  | ------------------------------------------------------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `body` <span className="required" title="required">\*</span> | `string`    | The comment content in markdown format.                                                                                                                                                                                                                 |
  | `issueId`                                                    | `string`    | The issue to associate the comment with.                                                                                                                                                                                                                |
  | `projectId`                                                  | `string`    | The project to associate the comment with.                                                                                                                                                                                                              |
  | `projectUpdateId`                                            | `string`    | The project update to associate the comment with.                                                                                                                                                                                                       |
  | `initiativeId`                                               | `string`    | The initiative to associate the comment with.                                                                                                                                                                                                           |
  | `initiativeUpdateId`                                         | `string`    | The initiative update to associate the comment with.                                                                                                                                                                                                    |
  | `documentContentId`                                          | `string`    | The document content to associate the comment with.                                                                                                                                                                                                     |
  | `postId`                                                     | `string`    | The post to associate the comment with.                                                                                                                                                                                                                 |
  | `parentId`                                                   | `string`    | The parent comment under which to nest this comment, for a threaded reply.                                                                                                                                                                              |
  | `quotedText`                                                 | `string`    | The text that this comment references, for an inline reply.                                                                                                                                                                                             |
  | `subscriberIds`                                              | `string`\[] | The identifiers of the users subscribing to this comment.                                                                                                                                                                                               |
  | `doNotSubscribeToIssue`                                      | `boolean`   | Whether to not subscribe the comment's author to the issue.                                                                                                                                                                                             |
  | `createOnSyncedSlackThread`                                  | `boolean`   | Flag to indicate this comment should be created on the issue's synced Slack comment thread. If no synced Slack comment thread exists, the mutation will fail. If there are multiple synced Slack threads on the issue, the oldest one will be targeted. |
  | `createdAt`                                                  | `string`    | The time at which the comment was created (e.g. if importing from another system). Must be a time in the past. If none is provided, the backend will generate the time as now.                                                                          |
  | `id`                                                         | `string`    | The identifier in UUID v4 format. If none is provided, the backend will generate one.                                                                                                                                                                   |
</div>

## CommentUpdateVariables

Variables for the `commentUpdate` mutation.

<div className="reference-table">
  | Field                                                         | Type                                      | Description           |
  | ------------------------------------------------------------- | ----------------------------------------- | --------------------- |
  | `id` <span className="required" title="required">\*</span>    | `string`                                  | The comment's UUID.   |
  | `input` <span className="required" title="required">\*</span> | [CommentUpdateInput](#commentupdateinput) | The fields to change. |
</div>

## CommentUpdateInput

The fields `commentUpdate` changes. All optional.

<div className="reference-table">
  | Field                | Type        | Description                                               |
  | -------------------- | ----------- | --------------------------------------------------------- |
  | `body`               | `string`    | The comment content in markdown format.                   |
  | `quotedText`         | `string`    | The text that this comment references.                    |
  | `resolvingUserId`    | `string`    | The user who resolved the comment.                        |
  | `resolvingCommentId` | `string`    | The comment that resolved this thread.                    |
  | `subscriberIds`      | `string`\[] | The identifiers of the users subscribing to this comment. |
</div>

## CommentDeleteVariables

Variables for the `commentDelete` mutation.

<div className="reference-table">
  | Field                                                      | Type     | Description         |
  | ---------------------------------------------------------- | -------- | ------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The comment's UUID. |
</div>

## CommentResolveVariables

Variables for the `commentResolve` mutation.

<div className="reference-table">
  | Field                                                      | Type     | Description                                       |
  | ---------------------------------------------------------- | -------- | ------------------------------------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The UUID of the comment thread to resolve.        |
  | `resolvingCommentId`                                       | `string` | The UUID of the comment that resolved the thread. |
</div>

## CommentUnresolveVariables

Variables for the `commentUnresolve` mutation.

<div className="reference-table">
  | Field                                                      | Type     | Description                               |
  | ---------------------------------------------------------- | -------- | ----------------------------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The UUID of the comment thread to reopen. |
</div>

## ReactionCreateVariables

Variables for the `reactionCreate` mutation.

<div className="reference-table">
  | Field                                                         | Type                                        | Description          |
  | ------------------------------------------------------------- | ------------------------------------------- | -------------------- |
  | `input` <span className="required" title="required">\*</span> | [ReactionCreateInput](#reactioncreateinput) | The reaction to add. |
</div>

## ReactionCreateInput

The input to `reactionCreate`.

<div className="reference-table">
  | Field                                                         | Type     | Description                                                                           |
  | ------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------- |
  | `emoji` <span className="required" title="required">\*</span> | `string` | The emoji the reaction represents, by name and without colons, e.g. '+1' or 'tada'.   |
  | `id`                                                          | `string` | The identifier in UUID v4 format. If none is provided, the backend will generate one. |
  | `commentId`                                                   | `string` | The comment to associate the reaction with.                                           |
  | `issueId`                                                     | `string` | The issue to associate the reaction with.                                             |
  | `projectUpdateId`                                             | `string` | The project update to associate the reaction with.                                    |
  | `initiativeUpdateId`                                          | `string` | The initiative update to associate the reaction with.                                 |
</div>

## ReactionDeleteVariables

Variables for the `reactionDelete` mutation.

<div className="reference-table">
  | Field                                                      | Type     | Description          |
  | ---------------------------------------------------------- | -------- | -------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The reaction's UUID. |
</div>