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

## Model tree

<div className="model-tree"><div className="model-tree-scroll"><div className="tree-node"><a href="#initiativeslistvariables">InitiativesListVariables</a><div className="tree-children"><div className="tree-node"><a href="#initiativefilter">InitiativeFilter</a><div className="tree-children"><div className="tree-node"><a href="#initiativelabelcollectionfilter">InitiativeLabelCollectionFilter</a><div className="tree-children"><div className="tree-node"><a href="#initiativelabelcollectionfilter">InitiativeLabelCollectionFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#initiativefilter">InitiativeFilter</a> <span className="tree-note">above</span></div></div></div></div></div><div className="tree-node"><a href="#initiativegetvariables">InitiativeGetVariables</a></div><div className="tree-node"><a href="#initiativecreatevariables">InitiativeCreateVariables</a><div className="tree-children"><div className="tree-node"><a href="#initiativecreateinput">InitiativeCreateInput</a></div></div></div><div className="tree-node"><a href="#initiativeupdatevariables">InitiativeUpdateVariables</a><div className="tree-children"><div className="tree-node"><a href="#initiativeupdateinput">InitiativeUpdateInput</a></div></div></div><div className="tree-node"><a href="#initiativeidvariables">InitiativeIdVariables</a></div><div className="tree-node"><a href="#initiativetoprojectcreatevariables">InitiativeToProjectCreateVariables</a><div className="tree-children"><div className="tree-node"><a href="#initiativetoprojectcreateinput">InitiativeToProjectCreateInput</a></div></div></div><div className="tree-node"><a href="#initiativetoprojectdeletevariables">InitiativeToProjectDeleteVariables</a></div><div className="tree-node"><a href="#initiativeupdateslistvariables">InitiativeUpdatesListVariables</a></div><div className="tree-node"><a href="#initiativeupdatecreatevariables">InitiativeUpdateCreateVariables</a><div className="tree-children"><div className="tree-node"><a href="#initiativeupdatecreateinput">InitiativeUpdateCreateInput</a></div></div></div></div></div>

## InitiativesListVariables

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

## InitiativeFilter

A filter over initiatives.

<div className="reference-table">
  | Field              | Type                                                                                         | Description                                                                   |
  | ------------------ | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
  | `id`               | [IdComparator](/charter/charter/packs/linear/workspace/objects#idcomparator)                         | Filter by initiative UUID.                                                    |
  | `name`             | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)                 | Filter by name.                                                               |
  | `status`           | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)                 | Filter by status: 'Planned', 'Proposed', 'Active', 'Completed' or 'Canceled'. |
  | `creator`          | [UserFilter](/charter/charter/packs/linear/workspace/objects#userfilter)                             | Filter by who created the initiative.                                         |
  | `owner`            | [UserFilter](/charter/charter/packs/linear/workspace/objects#userfilter)                             | Filter by the initiative's owner.                                             |
  | `targetDate`       | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Filter by the initiative's target date.                                       |
  | `createdAt`        | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)                     | Filter by when the initiative was created.                                    |
  | `updatedAt`        | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)                     | Filter by when the initiative was last updated.                               |
  | `slugId`           | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)                 | Comparator for the initiative's slug.                                         |
  | `customIdentifier` | [NullableStringComparator](/charter/charter/packs/linear/workspace/objects#nullablestringcomparator) | Comparator for the initiative's custom identifier.                            |
  | `priority`         | [NullableNumberComparator](/charter/charter/packs/linear/issues/objects#nullablenumbercomparator)    | Comparator for the initiative's priority.                                     |
  | `health`           | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)                 | Comparator for the initiative's health.                                       |
  | `healthWithAge`    | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)                 | Comparator for the initiative's health, with age.                             |
  | `activityType`     | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)                 | Comparator for the initiative's activity type.                                |
  | `startedAt`        | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Comparator for the initiative's started date.                                 |
  | `completedAt`      | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Comparator for the initiative's completed date.                               |
  | `canceledAt`       | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)     | Comparator for the initiative's canceled date.                                |
  | `leadTeam`         | [TeamFilter](/charter/charter/packs/linear/workspace/objects#teamfilter)                             | Filters that the initiative's lead team must satisfy.                         |
  | `labels`           | [InitiativeLabelCollectionFilter](#initiativelabelcollectionfilter)                          | Filters that the initiative labels must satisfy.                              |
</div>

## InitiativeLabelCollectionFilter

InitiativeLabelFilter plus collection operators.

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

## InitiativeGetVariables

Variables for the `initiative` query.

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

## InitiativeCreateVariables

Variables for the `initiativeCreate` mutation.

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

## InitiativeCreateInput

The input to `initiativeCreate`.

<div className="reference-table">
  | Field                                                        | Type                                                                            | Description                                                                                                                                     |
  | ------------------------------------------------------------ | ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
  | `name` <span className="required" title="required">\*</span> | `string`                                                                        | The name of the initiative.                                                                                                                     |
  | `description`                                                | `string`                                                                        | The description of the initiative.                                                                                                              |
  | `content`                                                    | `string`                                                                        | The initiative content as markdown.                                                                                                             |
  | `status`                                                     | [InitiativeStatus](#initiativestatus)                                           | The status of the initiative.                                                                                                                   |
  | `ownerId`                                                    | `string`                                                                        | The owner of the initiative.                                                                                                                    |
  | `leadTeamId`                                                 | `string`                                                                        | The identifier of the team leading the initiative.                                                                                              |
  | `labelIds`                                                   | `string`\[]                                                                     | The identifiers of the labels associated with this initiative.                                                                                  |
  | `priority`                                                   | `integer`                                                                       | The priority of the initiative. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low. <span className="field-constraints">≥ 0; ≤ 4</span> |
  | `targetDate`                                                 | `string`                                                                        | The estimated completion date of the initiative, as `YYYY-MM-DD`.                                                                               |
  | `targetDateResolution`                                       | [DateResolutionType](/charter/charter/packs/linear/projects/objects#dateresolutiontype) | The resolution of the initiative's estimated completion date.                                                                                   |
  | `icon`                                                       | `string`                                                                        | The icon of the initiative.                                                                                                                     |
  | `color`                                                      | `string`                                                                        | The color of the initiative, as a hex string.                                                                                                   |
  | `sortOrder`                                                  | `number`                                                                        | The sort order of the initiative within the workspace.                                                                                          |
  | `prioritySortOrder`                                          | `number`                                                                        | The sort order of the initiative within the workspace, when ordered by priority.                                                                |
  | `id`                                                         | `string`                                                                        | The identifier in UUID v4 format. If none is provided, the backend will generate one.                                                           |
</div>

## InitiativeUpdateVariables

Variables for the `initiativeUpdate` mutation.

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

## InitiativeUpdateInput

The fields the `initiativeUpdate` mutation changes. All optional.

<div className="reference-table">
  | Field                            | Type                                                                                      | Description                                                                                                                                     |
  | -------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
  | `name`                           | `string`                                                                                  | The name of the initiative.                                                                                                                     |
  | `description`                    | `string`                                                                                  | The description of the initiative.                                                                                                              |
  | `content`                        | `string`                                                                                  | The initiative content as markdown.                                                                                                             |
  | `status`                         | [InitiativeStatus](#initiativestatus)                                                     | The status of the initiative.                                                                                                                   |
  | `ownerId`                        | `string`                                                                                  | The owner of the initiative.                                                                                                                    |
  | `leadTeamId`                     | `string`                                                                                  | The identifier of the team leading the initiative.                                                                                              |
  | `labelIds`                       | `string`\[]                                                                               | The identifiers of the labels associated with this initiative.                                                                                  |
  | `priority`                       | `integer`                                                                                 | The priority of the initiative. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low. <span className="field-constraints">≥ 0; ≤ 4</span> |
  | `targetDate`                     | `string`                                                                                  | The estimated completion date of the initiative, as `YYYY-MM-DD`.                                                                               |
  | `targetDateResolution`           | [DateResolutionType](/charter/charter/packs/linear/projects/objects#dateresolutiontype)           | The resolution of the initiative's estimated completion date.                                                                                   |
  | `icon`                           | `string`                                                                                  | The icon of the initiative.                                                                                                                     |
  | `color`                          | `string`                                                                                  | The color of the initiative, as a hex string.                                                                                                   |
  | `trashed`                        | `boolean`                                                                                 | Whether the initiative has been trashed.                                                                                                        |
  | `sortOrder`                      | `number`                                                                                  | The sort order of the initiative within the workspace.                                                                                          |
  | `prioritySortOrder`              | `number`                                                                                  | The sort order of the initiative within the workspace, when ordered by priority.                                                                |
  | `updateReminderFrequency`        | `number`                                                                                  | The frequency at which to prompt for initiative updates. When not set, reminders are inherited from workspace settings.                         |
  | `updateReminderFrequencyInWeeks` | `number`                                                                                  | The n-weekly frequency at which to prompt for initiative updates. When not set, reminders are inherited from workspace settings.                |
  | `frequencyResolution`            | [FrequencyResolutionType](/charter/charter/packs/linear/projects/objects#frequencyresolutiontype) | The resolution type for the update reminder frequency (e.g., weekly, biweekly).                                                                 |
  | `updateRemindersDay`             | [Day](/charter/charter/packs/linear/projects/objects#day)                                         | The day of the week on which to prompt for initiative updates.                                                                                  |
  | `updateRemindersHour`            | `integer`                                                                                 | The hour of the day (0-23) at which to prompt for initiative updates. <span className="field-constraints">≥ 0; ≤ 23</span>                      |
</div>

## InitiativeIdVariables

Variables for the initiative mutations that take only an id.

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

## InitiativeToProjectCreateVariables

Variables for the `initiativeToProjectCreate` mutation.

<div className="reference-table">
  | Field                                                         | Type                                                              | Description                           |
  | ------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------- |
  | `input` <span className="required" title="required">\*</span> | [InitiativeToProjectCreateInput](#initiativetoprojectcreateinput) | The project to add to the initiative. |
</div>

## InitiativeToProjectCreateInput

The input to `initiativeToProjectCreate` — puts a project in an initiative.

<div className="reference-table">
  | Field                                                                | Type     | Description                                                                           |
  | -------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------- |
  | `initiativeId` <span className="required" title="required">\*</span> | `string` | The identifier of the initiative.                                                     |
  | `projectId` <span className="required" title="required">\*</span>    | `string` | The identifier of the project.                                                        |
  | `sortOrder`                                                          | `number` | The sort order of the project within the initiative.                                  |
  | `id`                                                                 | `string` | The identifier in UUID v4 format. If none is provided, the backend will generate one. |
</div>

## InitiativeToProjectDeleteVariables

Variables for the `initiativeToProjectDelete` mutation.

<div className="reference-table">
  | Field                                                      | Type     | Description                                                                                          |
  | ---------------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The UUID of the initiative-to-project link, not of the project. It comes back from `initiative_get`. |
</div>

## InitiativeUpdatesListVariables

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

## InitiativeUpdateCreateVariables

Variables for the `initiativeUpdateCreate` mutation.

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

## InitiativeUpdateCreateInput

The input to `initiativeUpdateCreate` — a status post on an initiative.

<div className="reference-table">
  | Field                                                                | Type                                                                  | Description                                                                           |
  | -------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
  | `initiativeId` <span className="required" title="required">\*</span> | `string`                                                              | The initiative to associate the update with.                                          |
  | `body`                                                               | `string`                                                              | The content of the initiative update in markdown format.                              |
  | `health`                                                             | [ProjectHealth](/charter/charter/packs/linear/projects/objects#projecthealth) | The health of the initiative at the time of the update.                               |
  | `isDiffHidden`                                                       | `boolean`                                                             | Whether the diff between the current update and the previous one should be hidden.    |
  | `id`                                                                 | `string`                                                              | The identifier in UUID v4 format. If none is provided, the backend will generate one. |
</div>

## InitiativeStatus

<div className="enum-table">
  | Value       |
  | ----------- |
  | `Planned`   |
  | `Proposed`  |
  | `Active`    |
  | `Completed` |
  | `Canceled`  |
</div>