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

## Model tree

<div className="model-tree"><div className="model-tree-scroll"><div className="tree-node"><a href="#issuelabelslistvariables">IssueLabelsListVariables</a><div className="tree-children"><div className="tree-node"><a href="#issuelabelfilter">IssueLabelFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullableteamfilter">NullableTeamFilter</a><div className="tree-children"><div className="tree-node"><a href="#nullableteamfilter">NullableTeamFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#issuelabelfilter">IssueLabelFilter</a> <span className="tree-note">above</span></div></div></div></div></div><div className="tree-node"><a href="#issuelabelgetvariables">IssueLabelGetVariables</a></div><div className="tree-node"><a href="#issuelabelcreatevariables">IssueLabelCreateVariables</a><div className="tree-children"><div className="tree-node"><a href="#issuelabelcreateinput">IssueLabelCreateInput</a></div></div></div><div className="tree-node"><a href="#issuelabelupdatevariables">IssueLabelUpdateVariables</a><div className="tree-children"><div className="tree-node"><a href="#issuelabelupdateinput">IssueLabelUpdateInput</a></div></div></div><div className="tree-node"><a href="#issuelabeldeletevariables">IssueLabelDeleteVariables</a></div><div className="tree-node"><a href="#projectlabelslistvariables">ProjectLabelsListVariables</a></div></div></div>

## IssueLabelsListVariables

Variables for the `issueLabels` 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`          | [IssueLabelFilter](#issuelabelfilter)                                          | Narrow the labels returned.                                                                                                       |
  | `includeArchived` | `boolean`                                                                      | Include archived labels in the results.                                                                                           |
  | `orderBy`         | [PaginationOrderBy](/charter/charter/packs/linear/workspace/objects#paginationorderby) | Sort by 'createdAt' or 'updatedAt'.                                                                                               |
</div>

## IssueLabelFilter

A filter over labels.

<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.                                                        |
  | `isGroup`   | [BooleanComparator](/charter/charter/packs/linear/workspace/objects#booleancomparator) | Filter by whether the label is a group of other labels.                      |
  | `creator`   | [NullableUserFilter](/charter/charter/packs/linear/issues/objects#nullableuserfilter)  | Filters that the issue labels creator must satisfy.                          |
  | `team`      | [NullableTeamFilter](#nullableteamfilter)                                      | Filter by the team the label belongs to. Workspace-wide labels have no team. |
  | `createdAt` | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)       | Filter by when the label was created.                                        |
  | `updatedAt` | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)       | Filter by when the label was last updated.                                   |
</div>

## NullableTeamFilter

TeamFilter 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 team UUID.            |
  | `name` | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator) | Filter by team name.            |
  | `key`  | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator) | Filter by team key, e.g. 'ENG'. |
</div>

## IssueLabelGetVariables

Variables for the `issueLabel` query.

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

## IssueLabelCreateVariables

Variables for the `issueLabelCreate` mutation.

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

## IssueLabelCreateInput

The input to `issueLabelCreate`.

<div className="reference-table">
  | Field                                                        | Type      | Description                                                                                                                             |
  | ------------------------------------------------------------ | --------- | --------------------------------------------------------------------------------------------------------------------------------------- |
  | `name` <span className="required" title="required">\*</span> | `string`  | The name of the label.                                                                                                                  |
  | `color`                                                      | `string`  | The color of the label, as a hex string such as '#4ea7fc'.                                                                              |
  | `description`                                                | `string`  | The description of the label.                                                                                                           |
  | `teamId`                                                     | `string`  | The team associated with the label. Omit it for a label the whole workspace can use.                                                    |
  | `parentId`                                                   | `string`  | The identifier of the parent label group.                                                                                               |
  | `isGroup`                                                    | `boolean` | Whether the label is considered to be a group.                                                                                          |
  | `retiredAt`                                                  | `string`  | The time at which the label was retired. Set to null to restore a retired label. This schema cannot send null — absent means unchanged. |
  | `id`                                                         | `string`  | The identifier in UUID v4 format. If none is provided, the backend will generate one.                                                   |
</div>

## IssueLabelUpdateVariables

Variables for the `issueLabelUpdate` mutation.

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

## IssueLabelUpdateInput

The fields `issueLabelUpdate` changes. All optional.

<div className="reference-table">
  | Field         | Type      | Description                                                                                                                                                        |
  | ------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | `name`        | `string`  | The name of the label.                                                                                                                                             |
  | `color`       | `string`  | The color of the label, as a hex string such as '#4ea7fc'.                                                                                                         |
  | `description` | `string`  | The description of the label.                                                                                                                                      |
  | `parentId`    | `string`  | The identifier of the parent label group.                                                                                                                          |
  | `isGroup`     | `boolean` | Whether the label is considered to be a group.                                                                                                                     |
  | `retiredAt`   | `string`  | The time at which the label was retired, as an ISO 8601 timestamp. Retiring keeps the label on the issues that already carry it while taking it out of the picker. |
</div>

## IssueLabelDeleteVariables

Variables for the `issueLabelDelete` mutation.

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

## ProjectLabelsListVariables

Variables for the `projectLabels` 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 archived labels in the results.                                                                                           |
  | `orderBy`         | [PaginationOrderBy](/charter/charter/packs/linear/workspace/objects#paginationorderby) | Sort by 'createdAt' or 'updatedAt'.                                                                                               |
</div>