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

## Model tree

<div className="model-tree"><div className="model-tree-scroll"><div className="tree-node"><a href="#issueslistvariables">IssuesListVariables</a><div className="tree-children"><div className="tree-node"><a href="#issuefilter">IssueFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullablenumbercomparator">NullableNumberComparator</a></div><div className="tree-node"><a href="#estimatecomparator">EstimateComparator</a><div className="tree-children"><div className="tree-node"><a href="#nullablenumbercomparator">NullableNumberComparator</a></div></div></div><div className="tree-node"><a href="#nullabletimelessdatecomparator">NullableTimelessDateComparator</a></div><div className="tree-node"><a href="#cycleperiodcomparator">CyclePeriodComparator</a></div><div className="tree-node"><a href="#slastatuscomparator">SlaStatusComparator</a></div><div className="tree-node"><a href="#nullableuserfilter">NullableUserFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullableuserfilter">NullableUserFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#issuelabelcollectionfilter">IssueLabelCollectionFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullableuserfilter">NullableUserFilter</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#issuelabelcollectionfilter">IssueLabelCollectionFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nullableprojectfilter">NullableProjectFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullablenumbercomparator">NullableNumberComparator</a></div><div className="tree-node"><a href="#relationexistscomparator">RelationExistsComparator</a></div><div className="tree-node"><a href="#nullableprojectfilter">NullableProjectFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nullableprojectmilestonefilter">NullableProjectMilestoneFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullableprojectmilestonefilter">NullableProjectMilestoneFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nullablecyclefilter">NullableCycleFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullablecyclefilter">NullableCycleFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nullabletemplatefilter">NullableTemplateFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullabletemplatefilter">NullableTemplateFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#sourcemetadatacomparator">SourceMetadataComparator</a><div className="tree-children"><div className="tree-node"><a href="#subtypecomparator">SubTypeComparator</a></div><div className="tree-node"><a href="#workflowdefinitionidcomparator">WorkflowDefinitionIdComparator</a></div></div></div><div className="tree-node"><a href="#relationexistscomparator">RelationExistsComparator</a></div><div className="tree-node"><a href="#issuefilter">IssueFilter</a> <span className="tree-note">above</span></div></div></div></div></div><div className="tree-node"><a href="#issuegetvariables">IssueGetVariables</a></div><div className="tree-node"><a href="#issuecreatevariables">IssueCreateVariables</a><div className="tree-children"><div className="tree-node"><a href="#issuecreateinput">IssueCreateInput</a></div></div></div><div className="tree-node"><a href="#issueupdatevariables">IssueUpdateVariables</a><div className="tree-children"><div className="tree-node"><a href="#issueupdateinput">IssueUpdateInput</a></div></div></div><div className="tree-node"><a href="#issuebatchupdatevariables">IssueBatchUpdateVariables</a><div className="tree-children"><div className="tree-node"><a href="#issueupdateinput">IssueUpdateInput</a></div></div></div><div className="tree-node"><a href="#issuedeletevariables">IssueDeleteVariables</a></div><div className="tree-node"><a href="#issuearchivevariables">IssueArchiveVariables</a></div><div className="tree-node"><a href="#issueunarchivevariables">IssueUnarchiveVariables</a></div><div className="tree-node"><a href="#issuelabellinkvariables">IssueLabelLinkVariables</a></div><div className="tree-node"><a href="#issuesubscriptionvariables">IssueSubscriptionVariables</a></div><div className="tree-node"><a href="#issuerelationslistvariables">IssueRelationsListVariables</a></div><div className="tree-node"><a href="#issuerelationgetvariables">IssueRelationGetVariables</a></div><div className="tree-node"><a href="#issuerelationcreatevariables">IssueRelationCreateVariables</a><div className="tree-children"><div className="tree-node"><a href="#issuerelationcreateinput">IssueRelationCreateInput</a></div></div></div><div className="tree-node"><a href="#issuerelationupdatevariables">IssueRelationUpdateVariables</a><div className="tree-children"><div className="tree-node"><a href="#issuerelationupdateinput">IssueRelationUpdateInput</a></div></div></div><div className="tree-node"><a href="#issuerelationdeletevariables">IssueRelationDeleteVariables</a></div></div></div>

## IssuesListVariables

Variables for the `issues` 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`          | [IssueFilter](#issuefilter)                                                    | Narrow the issues returned. Conditions combine with AND.                                                                          |
  | `orderBy`         | [PaginationOrderBy](/charter/charter/packs/linear/workspace/objects#paginationorderby) | Sort by 'createdAt' or 'updatedAt'. Linear sorts by 'updatedAt' by default.                                                       |
  | `includeArchived` | `boolean`                                                                      | Include archived issues in the results.                                                                                           |
</div>

## IssueFilter

A filter over issues. Conditions on the same object combine with AND.

<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.                                                                |
  | `description`            | [NullableStringComparator](/charter/charter/packs/linear/workspace/objects#nullablestringcomparator) | Filter by issue description.                                                                    |
  | `priority`               | [NullableNumberComparator](#nullablenumbercomparator)                                        | Comparator for the issues priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low. |
  | `estimate`               | [EstimateComparator](#estimatecomparator)                                                    | Filter by the issue's estimate.                                                                 |
  | `dueDate`                | [NullableTimelessDateComparator](#nullabletimelessdatecomparator)                            | Filter by the issue's due date.                                                                 |
  | `createdAt`              | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)                     | Filter by when the issue was created.                                                           |
  | `updatedAt`              | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)                     | Filter by when the issue was last updated.                                                      |
  | `startedAt`              | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Comparator for the issues started at date.                                                      |
  | `completedAt`            | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Filter by when the issue was completed.                                                         |
  | `canceledAt`             | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Filter by when the issue was canceled.                                                          |
  | `triagedAt`              | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Comparator for the issues triaged at date.                                                      |
  | `archivedAt`             | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Filter by when the issue was archived.                                                          |
  | `snoozedUntilAt`         | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Comparator for the issues snoozed until date.                                                   |
  | `addedToCycleAt`         | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Comparator for the issues added to cycle at date.                                               |
  | `addedToCyclePeriod`     | [CyclePeriodComparator](#cycleperiodcomparator)                                              | Comparator for the period when issue was added to a cycle.                                      |
  | `autoArchivedAt`         | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Comparator for the issues auto archived at date.                                                |
  | `autoClosedAt`           | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Comparator for the issues auto closed at date.                                                  |
  | `slaBreachesAt`          | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Comparator for the issue's SLA breach date.                                                     |
  | `slaStatus`              | [SlaStatusComparator](#slastatuscomparator)                                                  | Comparator for the issues sla status.                                                           |
  | `customerCount`          | [NumberComparator](/charter/charter/packs/linear/workspace/objects#numbercomparator)                 | Count of customers.                                                                             |
  | `customerImportantCount` | [NumberComparator](/charter/charter/packs/linear/workspace/objects#numbercomparator)                 | Count of important customers.                                                                   |
  | `state`                  | [WorkflowStateFilter](/charter/charter/packs/linear/workspace/objects#workflowstatefilter)           | Filters that the issues state must satisfy.                                                     |
  | `assignee`               | [NullableUserFilter](#nullableuserfilter)                                                    | Filter by the issue's assignee.                                                                 |
  | `creator`                | [NullableUserFilter](#nullableuserfilter)                                                    | Filter by who created the issue.                                                                |
  | `delegate`               | [NullableUserFilter](#nullableuserfilter)                                                    | Filter by the agent the issue is delegated to.                                                  |
  | `snoozedBy`              | [NullableUserFilter](#nullableuserfilter)                                                    | Filters that the issues snoozer must satisfy.                                                   |
  | `team`                   | [TeamFilter](/charter/charter/packs/linear/workspace/objects#teamfilter)                             | Filters that the issues team must satisfy.                                                      |
  | `labels`                 | [IssueLabelCollectionFilter](#issuelabelcollectionfilter)                                    | Filters that issue labels must satisfy.                                                         |
  | `project`                | [NullableProjectFilter](#nullableprojectfilter)                                              | Filters that the issues project must satisfy.                                                   |
  | `projectMilestone`       | [NullableProjectMilestoneFilter](#nullableprojectmilestonefilter)                            | Filters that the issues project milestone must satisfy.                                         |
  | `cycle`                  | [NullableCycleFilter](#nullablecyclefilter)                                                  | Filters that the issues cycle must satisfy.                                                     |
  | `lastAppliedTemplate`    | [NullableTemplateFilter](#nullabletemplatefilter)                                            | Filters that the last applied template must satisfy.                                            |
  | `recurringIssueTemplate` | [NullableTemplateFilter](#nullabletemplatefilter)                                            | \[ALPHA] Filters that the recurring issue template must satisfy.                                |
  | `sourceMetadata`         | [SourceMetadataComparator](#sourcemetadatacomparator)                                        | Filters that the source must satisfy.                                                           |
  | `hasBlockedByRelations`  | [RelationExistsComparator](#relationexistscomparator)                                        | Comparator for filtering issues which are blocked.                                              |
  | `hasBlockingRelations`   | [RelationExistsComparator](#relationexistscomparator)                                        | Comparator for filtering issues which are blocking.                                             |
  | `hasDuplicateRelations`  | [RelationExistsComparator](#relationexistscomparator)                                        | Comparator for filtering issues which are duplicates.                                           |
  | `hasRelatedRelations`    | [RelationExistsComparator](#relationexistscomparator)                                        | Comparator for filtering issues with relations.                                                 |
  | `hasSharedUsers`         | [RelationExistsComparator](#relationexistscomparator)                                        | Comparator for filtering issues which have been shared with users outside of the team.          |
</div>

## NullableNumberComparator

A numeric comparator for a field that may be null.

<div className="reference-table">
  | Field  | Type        | Description                                                        |
  | ------ | ----------- | ------------------------------------------------------------------ |
  | `eq`   | `number`    | Equals the given value.                                            |
  | `neq`  | `number`    | Does not equal the given value.                                    |
  | `lt`   | `number`    | Is less than the given value.                                      |
  | `lte`  | `number`    | Is less than or equal to the given value.                          |
  | `gt`   | `number`    | Is greater than the given value.                                   |
  | `gte`  | `number`    | Is greater than or equal to the given value.                       |
  | `in_`  | `number`\[] | Is one of the given values.                                        |
  | `nin`  | `number`\[] | Is not one of the given values.                                    |
  | `null` | `boolean`   | True to match only where the field is null, false where it is set. |
</div>

## EstimateComparator

Comparators for an issue estimate.

<div className="reference-table">
  | Field  | Type                                                     | Description                                      |
  | ------ | -------------------------------------------------------- | ------------------------------------------------ |
  | `eq`   | `number`                                                 | Equals the given value.                          |
  | `neq`  | `number`                                                 | Does not equal the given value.                  |
  | `lt`   | `number`                                                 | Is less than the given value.                    |
  | `lte`  | `number`                                                 | Is less than or equal to the given value.        |
  | `gt`   | `number`                                                 | Is greater than the given value.                 |
  | `gte`  | `number`                                                 | Is greater than or equal to the given value.     |
  | `in_`  | `number`\[]                                              | Is one of the given values.                      |
  | `nin`  | `number`\[]                                              | Is not one of the given values.                  |
  | `null` | `boolean`                                                | True to match only where the estimate is unset.  |
  | `and_` | [NullableNumberComparator](#nullablenumbercomparator)\[] | Every comparator in this list must match.        |
  | `or_`  | [NullableNumberComparator](#nullablenumbercomparator)\[] | At least one comparator in this list must match. |
</div>

## NullableTimelessDateComparator

Comparators for a calendar date that may be null.

<div className="reference-table">
  | Field  | Type        | Description                                                        |
  | ------ | ----------- | ------------------------------------------------------------------ |
  | `eq`   | `string`    | Equals the given date.                                             |
  | `neq`  | `string`    | Does not equal the given date.                                     |
  | `lt`   | `string`    | Is before the given date.                                          |
  | `lte`  | `string`    | Is at or before the given date.                                    |
  | `gt`   | `string`    | Is after the given date.                                           |
  | `gte`  | `string`    | Is at or after the given date.                                     |
  | `in_`  | `string`\[] | Is one of the given dates.                                         |
  | `nin`  | `string`\[] | Is not one of the given dates.                                     |
  | `null` | `boolean`   | True to match only where the field is null, false where it is set. |
</div>

## CyclePeriodComparator

Comparators for which cycle period something falls in.

<div className="reference-table">
  | Field  | Type                           | Description                                       |
  | ------ | ------------------------------ | ------------------------------------------------- |
  | `eq`   | [CyclePeriod](#cycleperiod)    | Equals the given period.                          |
  | `neq`  | [CyclePeriod](#cycleperiod)    | Does not equal the given period.                  |
  | `in_`  | [CyclePeriod](#cycleperiod)\[] | Is one of the given periods.                      |
  | `nin`  | [CyclePeriod](#cycleperiod)\[] | Is not one of the given periods.                  |
  | `null` | `boolean`                      | True to match only where there is no such period. |
</div>

## SlaStatusComparator

Comparators for an issue's SLA status.

<div className="reference-table">
  | Field  | Type                       | Description                              |
  | ------ | -------------------------- | ---------------------------------------- |
  | `eq`   | [SlaStatus](#slastatus)    | Equals the given status.                 |
  | `neq`  | [SlaStatus](#slastatus)    | Does not equal the given status.         |
  | `in_`  | [SlaStatus](#slastatus)\[] | Is one of the given statuses.            |
  | `nin`  | [SlaStatus](#slastatus)\[] | Is not one of the given statuses.        |
  | `null` | `boolean`                  | True to match only where no SLA applies. |
</div>

## NullableUserFilter

UserFilter 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 user UUID.     |
  | `name`        | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator) | Filter by name.          |
  | `displayName` | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator) | Filter by display name.  |
  | `email`       | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator) | Filter by email address. |
</div>

## IssueLabelCollectionFilter

IssueLabelFilter plus collection operators.

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

## NullableProjectFilter

ProjectFilter 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 project UUID.       |
  | `name`   | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator) | Filter by project name.       |
  | `slugId` | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator) | Filter by the project's slug. |
</div>

## RelationExistsComparator

Whether a relationship exists at all.

<div className="reference-table">
  | Field | Type      | Description                                      |
  | ----- | --------- | ------------------------------------------------ |
  | `eq`  | `boolean` | True to match where the relation exists.         |
  | `neq` | `boolean` | True to match where the relation does not exist. |
</div>

## NullableProjectMilestoneFilter

ProjectMilestoneFilter 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 milestone UUID. |
  | `name` | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator) | Filter by name.           |
</div>

## NullableCycleFilter

CycleFilter 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 cycle UUID.          |
  | `name`   | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator) | Comparator for the cycle name. |
  | `number` | [NumberComparator](/charter/charter/packs/linear/workspace/objects#numbercomparator) | Filter by the cycle's number.  |
</div>

## NullableTemplateFilter

TemplateFilter 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 template UUID.            |
  | `name` | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator) | Filter by name.                     |
  | `type` | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator) | Comparator for the template's type. |
</div>

## SourceMetadataComparator

Comparators for how an issue was created — an integration, intake, or not.

<div className="reference-table">
  | Field                  | Type                                                              | Description                                                                                                                                                                                                                                       |
  | ---------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `null`                 | `boolean`                                                         | When true, matches issues without an external source: issues with no source metadata and issues created through the API, an OAuth application, or a loop. When false, matches issues created by an integration or an intake source such as email. |
  | `subType`              | [SubTypeComparator](#subtypecomparator)                           | Comparator for the sub type.                                                                                                                                                                                                                      |
  | `workflowDefinitionId` | [WorkflowDefinitionIdComparator](#workflowdefinitionidcomparator) | Comparator for the workflow definition that created the issue.                                                                                                                                                                                    |
</div>

## SubTypeComparator

Comparators for a source subtype string that may be null.

<div className="reference-table">
  | Field  | Type        | Description                                    |
  | ------ | ----------- | ---------------------------------------------- |
  | `eq`   | `string`    | Equals the given value.                        |
  | `neq`  | `string`    | Does not equal the given value.                |
  | `in_`  | `string`\[] | Is one of the given values.                    |
  | `nin`  | `string`\[] | Is not one of the given values.                |
  | `null` | `boolean`   | True to match only where the subtype is unset. |
</div>

## WorkflowDefinitionIdComparator

Comparators for the workflow definition that created an issue.

<div className="reference-table">
  | Field  | Type        | Description                                              |
  | ------ | ----------- | -------------------------------------------------------- |
  | `eq`   | `string`    | Equals the given UUID.                                   |
  | `neq`  | `string`    | Does not equal the given UUID.                           |
  | `in_`  | `string`\[] | Is one of the given UUIDs.                               |
  | `nin`  | `string`\[] | Is not one of the given UUIDs.                           |
  | `null` | `boolean`   | True to match only where no workflow definition applies. |
</div>

## IssueGetVariables

Variables for the `issue` query.

<div className="reference-table">
  | Field                                                      | Type     | Description                                                                          |
  | ---------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------ |
  | `id` <span className="required" title="required">\*</span> | `string` | The issue's UUID, or its human identifier such as 'ENG-123'. Both are accepted here. |
</div>

## IssueCreateVariables

Variables for the `issueCreate` mutation.

<div className="reference-table">
  | Field                                                         | Type                                  | Description          |
  | ------------------------------------------------------------- | ------------------------------------- | -------------------- |
  | `input` <span className="required" title="required">\*</span> | [IssueCreateInput](#issuecreateinput) | The issue to create. |
</div>

## IssueCreateInput

The input to `issueCreate`.

<div className="reference-table">
  | Field                                                          | Type                                | Description                                                                                                                                                                                |
  | -------------------------------------------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | `teamId` <span className="required" title="required">\*</span> | `string`                            | UUID of the team the issue belongs to. Required. Use `teams_list` to resolve a team key such as 'ENG' to its UUID.                                                                         |
  | `title` <span className="required" title="required">\*</span>  | `string`                            | The issue title.                                                                                                                                                                           |
  | `description`                                                  | `string`                            | The issue description in markdown format.                                                                                                                                                  |
  | `assigneeId`                                                   | `string`                            | The identifier of the user to assign the issue to. Use `users_list` to resolve a name.                                                                                                     |
  | `priority`                                                     | `integer`                           | The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.                                                                                                     |
  | `stateId`                                                      | `string`                            | The team state of the issue. Use `workflow_states_list` to resolve a state name such as 'In Progress'. Omit to use the team's default.                                                     |
  | `labelIds`                                                     | `string`\[]                         | The identifiers of the issue labels associated with this ticket.                                                                                                                           |
  | `projectId`                                                    | `string`                            | The project associated with the issue.                                                                                                                                                     |
  | `projectMilestoneId`                                           | `string`                            | The project milestone associated with the issue.                                                                                                                                           |
  | `cycleId`                                                      | `string`                            | The cycle associated with the issue.                                                                                                                                                       |
  | `parentId`                                                     | `string`                            | The identifier of the parent issue, to create this as a sub-issue. Can be a UUID or issue identifier (e.g., 'LIN-123').                                                                    |
  | `subscriberIds`                                                | `string`\[]                         | The identifiers of the users subscribing to this ticket.                                                                                                                                   |
  | `estimate`                                                     | `integer`                           | The estimated complexity of the issue.                                                                                                                                                     |
  | `dueDate`                                                      | `string`                            | The date at which the issue is due, as `YYYY-MM-DD`.                                                                                                                                       |
  | `sortOrder`                                                    | `number`                            | The position of the issue related to other issues.                                                                                                                                         |
  | `prioritySortOrder`                                            | `number`                            | The position of the issue related to other issues, when ordered by priority.                                                                                                               |
  | `subIssueSortOrder`                                            | `number`                            | The position of the issue in parent's sub-issue list.                                                                                                                                      |
  | `preserveSortOrderOnCreate`                                    | `boolean`                           | Whether the passed sort order should be preserved.                                                                                                                                         |
  | `delegateId`                                                   | `string`                            | The identifier of the agent user to delegate the issue to.                                                                                                                                 |
  | `slaType`                                                      | [SlaDayCountType](#sladaycounttype) | The SLA day count type for the issue. Whether SLA should be business days only or calendar days (default).                                                                                 |
  | `templateId`                                                   | `string`                            | The identifier of a template the issue should be created from. If other values are provided in the input, they will override template values.                                              |
  | `lastAppliedTemplateId`                                        | `string`                            | The ID of the last template applied to the issue.                                                                                                                                          |
  | `useDefaultTemplate`                                           | `boolean`                           | Whether to use the default template for the team. When set to true, the default template of this team based on user's membership will be applied.                                          |
  | `sourceCommentId`                                              | `string`                            | The comment the issue is created from.                                                                                                                                                     |
  | `referenceCommentId`                                           | `string`                            | The comment the issue is referencing.                                                                                                                                                      |
  | `releaseIds`                                                   | `string`\[]                         | The identifiers of the releases to associate with this issue.                                                                                                                              |
  | `createdAt`                                                    | `string`                            | The time at which the issue 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.               |
  | `completedAt`                                                  | `string`                            | The time at which the issue was completed (e.g. if importing from another system). Must be a time in the past and after createdAt. Cannot be provided with an incompatible workflow state. |
  | `id`                                                           | `string`                            | The identifier in UUID v4 format. If none is provided, the backend will generate one.                                                                                                      |
</div>

## IssueUpdateVariables

Variables for the `issueUpdate` mutation.

<div className="reference-table">
  | Field                                                         | Type                                  | Description                                |
  | ------------------------------------------------------------- | ------------------------------------- | ------------------------------------------ |
  | `id` <span className="required" title="required">\*</span>    | `string`                              | UUID or identifier of the issue to update. |
  | `input` <span className="required" title="required">\*</span> | [IssueUpdateInput](#issueupdateinput) | The fields to change.                      |
</div>

## IssueUpdateInput

The input to `issueUpdate`. Every field is optional.

<div className="reference-table">
  | Field                       | Type                                | Description                                                                                                                            |
  | --------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
  | `title`                     | `string`                            | The issue title.                                                                                                                       |
  | `description`               | `string`                            | The issue description in markdown format. Replaces the existing one.                                                                   |
  | `assigneeId`                | `string`                            | The identifier of the user to assign the issue to.                                                                                     |
  | `priority`                  | `integer`                           | The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.                                                 |
  | `stateId`                   | `string`                            | The team state of the issue. This is how an issue is closed: move it to a state whose type is 'completed' or 'canceled'.               |
  | `labelIds`                  | `string`\[]                         | The complete set of label identifiers for the issue. This *replaces* the issue's labels; use `added_label_ids` to add to them instead. |
  | `addedLabelIds`             | `string`\[]                         | The identifiers of the issue labels to be added to this issue.                                                                         |
  | `removedLabelIds`           | `string`\[]                         | The identifiers of the issue labels to be removed from this issue.                                                                     |
  | `teamId`                    | `string`                            | The identifier of the team to move the issue to.                                                                                       |
  | `projectId`                 | `string`                            | The project associated with the issue.                                                                                                 |
  | `projectMilestoneId`        | `string`                            | The project milestone associated with the issue.                                                                                       |
  | `cycleId`                   | `string`                            | The cycle associated with the issue.                                                                                                   |
  | `parentId`                  | `string`                            | The identifier of the parent issue.                                                                                                    |
  | `subscriberIds`             | `string`\[]                         | The identifiers of the users subscribing to this ticket.                                                                               |
  | `estimate`                  | `integer`                           | The estimated complexity of the issue.                                                                                                 |
  | `dueDate`                   | `string`                            | The date at which the issue is due, as `YYYY-MM-DD`.                                                                                   |
  | `snoozedUntilAt`            | `string`                            | The time until which the issue is snoozed, as an ISO 8601 timestamp.                                                                   |
  | `snoozedById`               | `string`                            | The identifier of the user who snoozed the issue.                                                                                      |
  | `delegateId`                | `string`                            | The identifier of the agent user to delegate the issue to.                                                                             |
  | `trashed`                   | `boolean`                           | Whether the issue has been moved to the trash.                                                                                         |
  | `sortOrder`                 | `number`                            | The position of the issue related to other issues.                                                                                     |
  | `prioritySortOrder`         | `number`                            | The position of the issue related to other issues, when ordered by priority.                                                           |
  | `subIssueSortOrder`         | `number`                            | The position of the issue in parent's sub-issue list.                                                                                  |
  | `slaType`                   | [SlaDayCountType](#sladaycounttype) | The SLA day count type for the issue. Whether SLA should be business days only or calendar days (default).                             |
  | `lastAppliedTemplateId`     | `string`                            | The ID of the last template applied to the issue.                                                                                      |
  | `releaseIds`                | `string`\[]                         | The identifiers of the releases associated with this issue.                                                                            |
  | `addedReleaseIds`           | `string`\[]                         | The identifiers of the releases to be added to this issue.                                                                             |
  | `removedReleaseIds`         | `string`\[]                         | The identifiers of the releases to be removed from this issue.                                                                         |
  | `autoClosedByParentClosing` | `boolean`                           | Whether the issue was automatically closed because its parent issue was closed.                                                        |
  | `inheritsSharedAccess`      | `boolean`                           | Whether this issue should inherit shared access from its parent issue.                                                                 |
</div>

## IssueBatchUpdateVariables

Variables for the `issueBatchUpdate` mutation.

<div className="reference-table">
  | Field                                                         | Type                                  | Description                                                                                                                                       |
  | ------------------------------------------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `ids` <span className="required" title="required">\*</span>   | `string`\[]                           | The UUIDs of the issues to update. These must be UUIDs, not identifiers such as 'ENG-123'. <span className="field-constraints">min 1 items</span> |
  | `input` <span className="required" title="required">\*</span> | [IssueUpdateInput](#issueupdateinput) | The fields to change, applied to every issue in `ids`.                                                                                            |
</div>

## IssueDeleteVariables

Variables for the `issueDelete` mutation.

<div className="reference-table">
  | Field                                                      | Type      | Description                                                                                                                              |
  | ---------------------------------------------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
  | `id` <span className="required" title="required">\*</span> | `string`  | The issue's UUID.                                                                                                                        |
  | `permanentlyDelete`                                        | `boolean` | Permanently delete the issue instead of moving it to the trash. This cannot be undone. Absent, the issue is trashed and can be restored. |
</div>

## IssueArchiveVariables

Variables for the `issueArchive` mutation.

<div className="reference-table">
  | Field                                                      | Type      | Description                                                                                     |
  | ---------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------- |
  | `id` <span className="required" title="required">\*</span> | `string`  | The issue's UUID.                                                                               |
  | `trash`                                                    | `boolean` | Send the issue to the trash as well as archiving it. Absent, it is archived and stays findable. |
</div>

## IssueUnarchiveVariables

Variables for the `issueUnarchive` mutation.

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

## IssueLabelLinkVariables

Variables for `issueAddLabel` and `issueRemoveLabel`.

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

## IssueSubscriptionVariables

Variables for `issueSubscribe` and `issueUnsubscribe`.

<div className="reference-table">
  | Field                                                      | Type     | Description                                                                                          |
  | ---------------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The issue's UUID.                                                                                    |
  | `userId`                                                   | `string` | The UUID of the user to subscribe. Omit both this and `user_email` to act on the authenticated user. |
  | `userEmail`                                                | `string` | The email address of the user to subscribe.                                                          |
</div>

## IssueRelationsListVariables

Variables for the `issueRelations` 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.                                                      |
  | `includeArchived` | `boolean`                                                                      | Include relations on archived issues.                                                                                             |
  | `orderBy`         | [PaginationOrderBy](/charter/charter/packs/linear/workspace/objects#paginationorderby) | Sort by 'createdAt' or 'updatedAt'.                                                                                               |
</div>

## IssueRelationGetVariables

Variables for the `issueRelation` query.

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

## IssueRelationCreateVariables

Variables for the `issueRelationCreate` mutation.

<div className="reference-table">
  | Field                                                         | Type                                                  | Description             |
  | ------------------------------------------------------------- | ----------------------------------------------------- | ----------------------- |
  | `input` <span className="required" title="required">\*</span> | [IssueRelationCreateInput](#issuerelationcreateinput) | The relation to create. |
</div>

## IssueRelationCreateInput

The input to `issueRelationCreate`.

<div className="reference-table">
  | Field                                                                  | Type                                    | Description                                                                           |
  | ---------------------------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------- |
  | `issueId` <span className="required" title="required">\*</span>        | `string`                                | The identifier of the issue that is related.                                          |
  | `relatedIssueId` <span className="required" title="required">\*</span> | `string`                                | The identifier of the related issue.                                                  |
  | `type` <span className="required" title="required">\*</span>           | [IssueRelationType](#issuerelationtype) | The type of relation between the two issues.                                          |
  | `id`                                                                   | `string`                                | The identifier in UUID v4 format. If none is provided, the backend will generate one. |
</div>

## IssueRelationUpdateVariables

Variables for the `issueRelationUpdate` mutation.

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

## IssueRelationUpdateInput

The fields `issueRelationUpdate` changes. All optional.

<div className="reference-table">
  | Field            | Type                                    | Description                                  |
  | ---------------- | --------------------------------------- | -------------------------------------------- |
  | `issueId`        | `string`                                | The identifier of the issue that is related. |
  | `relatedIssueId` | `string`                                | The identifier of the related issue.         |
  | `type`           | [IssueRelationType](#issuerelationtype) | The type of relation between the two issues. |
</div>

## IssueRelationDeleteVariables

Variables for the `issueRelationDelete` mutation.

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

## IssueRelationType

<div className="enum-table">
  | Value       |
  | ----------- |
  | `blocks`    |
  | `duplicate` |
  | `related`   |
  | `similar`   |
</div>

## SlaDayCountType

<div className="enum-table">
  | Value              |
  | ------------------ |
  | `all`              |
  | `onlyBusinessDays` |
</div>

## SlaStatus

<div className="enum-table">
  | Value        |
  | ------------ |
  | `Breached`   |
  | `Completed`  |
  | `Failed`     |
  | `HighRisk`   |
  | `LowRisk`    |
  | `MediumRisk` |
</div>

## CyclePeriod

<div className="enum-table">
  | Value    |
  | -------- |
  | `after`  |
  | `before` |
  | `during` |
</div>