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

## Model tree

<div className="model-tree"><div className="model-tree-scroll"><div className="tree-node"><a href="#projectslistvariables">ProjectsListVariables</a><div className="tree-children"><div className="tree-node"><a href="#projectfilter">ProjectFilter</a><div className="tree-children"><div className="tree-node"><a href="#projectstatusfilter">ProjectStatusFilter</a><div className="tree-children"><div className="tree-node"><a href="#projectstatusfilter">ProjectStatusFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#templatefilter">TemplateFilter</a><div className="tree-children"><div className="tree-node"><a href="#templatefilter">TemplateFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#projectmilestonefilter">ProjectMilestoneFilter</a><div className="tree-children"><div className="tree-node"><a href="#projectfilter">ProjectFilter</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#projectmilestonefilter">ProjectMilestoneFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#projectlabelcollectionfilter">ProjectLabelCollectionFilter</a><div className="tree-children"><div className="tree-node"><a href="#projectlabelcollectionfilter">ProjectLabelCollectionFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#projectfilter">ProjectFilter</a> <span className="tree-note">above</span></div></div></div></div></div><div className="tree-node"><a href="#projectgetvariables">ProjectGetVariables</a></div><div className="tree-node"><a href="#projectcreatevariables">ProjectCreateVariables</a><div className="tree-children"><div className="tree-node"><a href="#projectcreateinput">ProjectCreateInput</a></div></div></div><div className="tree-node"><a href="#projectupdatevariables">ProjectUpdateVariables</a><div className="tree-children"><div className="tree-node"><a href="#projectupdateinput">ProjectUpdateInput</a></div></div></div><div className="tree-node"><a href="#projectdeletevariables">ProjectDeleteVariables</a></div><div className="tree-node"><a href="#projectunarchivevariables">ProjectUnarchiveVariables</a></div><div className="tree-node"><a href="#projectlabellinkvariables">ProjectLabelLinkVariables</a></div><div className="tree-node"><a href="#pagevariables">PageVariables</a></div><div className="tree-node"><a href="#projectmilestoneslistvariables">ProjectMilestonesListVariables</a><div className="tree-children"><div className="tree-node"><a href="#projectmilestonefilter">ProjectMilestoneFilter</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#projectmilestonegetvariables">ProjectMilestoneGetVariables</a></div><div className="tree-node"><a href="#projectmilestonecreatevariables">ProjectMilestoneCreateVariables</a><div className="tree-children"><div className="tree-node"><a href="#projectmilestonecreateinput">ProjectMilestoneCreateInput</a></div></div></div><div className="tree-node"><a href="#projectmilestoneupdatevariables">ProjectMilestoneUpdateVariables</a><div className="tree-children"><div className="tree-node"><a href="#projectmilestoneupdateinput">ProjectMilestoneUpdateInput</a></div></div></div><div className="tree-node"><a href="#projectmilestonedeletevariables">ProjectMilestoneDeleteVariables</a></div><div className="tree-node"><a href="#projectupdateslistvariables">ProjectUpdatesListVariables</a><div className="tree-children"><div className="tree-node"><a href="#projectupdatefilter">ProjectUpdateFilter</a><div className="tree-children"><div className="tree-node"><a href="#projectfilter">ProjectFilter</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#projectupdatefilter">ProjectUpdateFilter</a> <span className="tree-note">above</span></div></div></div></div></div><div className="tree-node"><a href="#projectupdategetvariables">ProjectUpdateGetVariables</a></div><div className="tree-node"><a href="#projectupdatecreatevariables">ProjectUpdateCreateVariables</a><div className="tree-children"><div className="tree-node"><a href="#projectupdatecreateinput">ProjectUpdateCreateInput</a></div></div></div><div className="tree-node"><a href="#projectupdateupdatevariables">ProjectUpdateUpdateVariables</a><div className="tree-children"><div className="tree-node"><a href="#projectupdateupdateinput">ProjectUpdateUpdateInput</a></div></div></div><div className="tree-node"><a href="#projectupdatearchivevariables">ProjectUpdateArchiveVariables</a></div></div></div>

## ProjectsListVariables

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

## ProjectFilter

A filter over projects, or over an issue's `project`.

<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.                                                                |
  | `priority`               | [NullableNumberComparator](/charter/charter/packs/linear/issues/objects#nullablenumbercomparator) | Filter by the project's priority.                                                            |
  | `health`                 | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)              | Filter by the project's health: 'onTrack', 'atRisk' or 'offTrack'.                           |
  | `state`                  | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)              | Filter by the project's state, such as 'planned', 'started', 'completed' or 'canceled'.      |
  | `startDate`              | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)  | Filter by the project's start date.                                                          |
  | `targetDate`             | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)  | Filter by the project's target date.                                                         |
  | `completedAt`            | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)  | Filter by when the project was completed.                                                    |
  | `canceledAt`             | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)  | Filter by when the project was canceled.                                                     |
  | `createdAt`              | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)                  | Filter by when the project was created.                                                      |
  | `updatedAt`              | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)                  | Filter by when the project was last updated.                                                 |
  | `lead`                   | [UserFilter](/charter/charter/packs/linear/workspace/objects#userfilter)                          | Filter by the project's lead.                                                                |
  | `creator`                | [UserFilter](/charter/charter/packs/linear/workspace/objects#userfilter)                          | Filter by who created the project.                                                           |
  | `startedAt`              | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator)  | Comparator for the project started date (when it was moved to an "In Progress" status).      |
  | `activityType`           | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)              | Comparator for the project activity type: buzzin, active, some, none.                        |
  | `healthWithAge`          | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)              | Comparator for the project health (with age): onTrack, atRisk, offTrack, outdated, noUpdate. |
  | `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.                                                                |
  | `hasBlockedByRelations`  | [RelationExistsComparator](/charter/charter/packs/linear/issues/objects#relationexistscomparator) | Comparator for filtering projects which are blocked.                                         |
  | `hasBlockingRelations`   | [RelationExistsComparator](/charter/charter/packs/linear/issues/objects#relationexistscomparator) | Comparator for filtering projects which are blocking.                                        |
  | `hasRelatedRelations`    | [RelationExistsComparator](/charter/charter/packs/linear/issues/objects#relationexistscomparator) | Comparator for filtering projects with relations.                                            |
  | `hasViolatedRelations`   | [RelationExistsComparator](/charter/charter/packs/linear/issues/objects#relationexistscomparator) | Comparator for filtering projects with violated dependencies.                                |
  | `status`                 | [ProjectStatusFilter](#projectstatusfilter)                                               | Filters that the project status must satisfy.                                                |
  | `leadTeam`               | [TeamFilter](/charter/charter/packs/linear/workspace/objects#teamfilter)                          | Filters that the project's lead team must satisfy.                                           |
  | `lastAppliedTemplate`    | [TemplateFilter](#templatefilter)                                                         | Filters that the last applied template must satisfy.                                         |
  | `nextProjectMilestone`   | [ProjectMilestoneFilter](#projectmilestonefilter)                                         | Filters that the project's next milestone must satisfy.                                      |
  | `labels`                 | [ProjectLabelCollectionFilter](#projectlabelcollectionfilter)                             | Filters that project labels must satisfy.                                                    |
</div>

## ProjectStatusFilter

A filter over project statuses.

<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 project status name. |
  | `type` | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator) | Comparator for the project status type. |
</div>

## TemplateFilter

A filter over templates.

<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>

## ProjectMilestoneFilter

A filter over project milestones.

<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.                                            |
  | `targetDate` | [NullableDateComparator](/charter/charter/packs/linear/workspace/objects#nullabledatecomparator) | Filter by the milestone's target date.                     |
  | `createdAt`  | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)                 | Filter by when the milestone was created.                  |
  | `updatedAt`  | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)                 | Filter by when the milestone was last updated.             |
  | `project`    | [ProjectFilter](#projectfilter)                                                          | Filters that the project milestone's project must satisfy. |
</div>

## ProjectLabelCollectionFilter

ProjectLabelFilter 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>

## ProjectGetVariables

Variables for the `project` query.

<div className="reference-table">
  | Field                                                      | Type     | Description                                   |
  | ---------------------------------------------------------- | -------- | --------------------------------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The project's UUID, or the slug from its URL. |
</div>

## ProjectCreateVariables

Variables for the `projectCreate` mutation.

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

## ProjectCreateInput

The input to `projectCreate`.

<div className="reference-table">
  | Field                                                           | Type                                      | Description                                                                                                                                  |
  | --------------------------------------------------------------- | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
  | `name` <span className="required" title="required">\*</span>    | `string`                                  | The name of the project.                                                                                                                     |
  | `teamIds` <span className="required" title="required">\*</span> | `string`\[]                               | The identifiers of the teams this project is associated with. <span className="field-constraints">min 1 items</span>                         |
  | `description`                                                   | `string`                                  | The description for the project.                                                                                                             |
  | `content`                                                       | `string`                                  | The project content as markdown.                                                                                                             |
  | `statusId`                                                      | `string`                                  | The ID of the project status. Use `project_statuses_list` to resolve a name such as 'In Progress' to its UUID.                               |
  | `leadId`                                                        | `string`                                  | The identifier of the project lead.                                                                                                          |
  | `memberIds`                                                     | `string`\[]                               | The identifiers of the members of this project.                                                                                              |
  | `labelIds`                                                      | `string`\[]                               | The identifiers of the project labels associated with this project.                                                                          |
  | `priority`                                                      | `integer`                                 | The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low. <span className="field-constraints">≥ 0; ≤ 4</span> |
  | `startDate`                                                     | `string`                                  | The planned start date of the project, as `YYYY-MM-DD`.                                                                                      |
  | `startDateResolution`                                           | [DateResolutionType](#dateresolutiontype) | The resolution of the project's start date.                                                                                                  |
  | `targetDate`                                                    | `string`                                  | The planned target date of the project, as `YYYY-MM-DD`.                                                                                     |
  | `targetDateResolution`                                          | [DateResolutionType](#dateresolutiontype) | The resolution of the project's estimated completion date.                                                                                   |
  | `icon`                                                          | `string`                                  | The icon of the project.                                                                                                                     |
  | `color`                                                         | `string`                                  | The color of the project, as a hex string.                                                                                                   |
  | `convertedFromIssueId`                                          | `string`                                  | The ID of the issue that was converted into this project.                                                                                    |
  | `lastAppliedTemplateId`                                         | `string`                                  | The ID of the last template applied to the project.                                                                                          |
  | `templateId`                                                    | `string`                                  | The ID of a project template to apply when creating the project. Overrides useDefaultTemplate if both are provided.                          |
  | `useDefaultTemplate`                                            | `boolean`                                 | When set to true, the default project template of the first team provided will be applied. If templateId is provided, this will be ignored.  |
  | `sortOrder`                                                     | `number`                                  | The sort order for the project within shared views.                                                                                          |
  | `prioritySortOrder`                                             | `number`                                  | The sort order for the project within shared views, when ordered by priority.                                                                |
  | `id`                                                            | `string`                                  | The identifier in UUID v4 format. If none is provided, the backend will generate one.                                                        |
</div>

## ProjectUpdateVariables

Variables for the `projectUpdate` mutation.

<div className="reference-table">
  | Field                                                         | Type                                      | Description                                   |
  | ------------------------------------------------------------- | ----------------------------------------- | --------------------------------------------- |
  | `id` <span className="required" title="required">\*</span>    | `string`                                  | The project's UUID, or the slug from its URL. |
  | `input` <span className="required" title="required">\*</span> | [ProjectUpdateInput](#projectupdateinput) | The fields to change.                         |
</div>

## ProjectUpdateInput

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

<div className="reference-table">
  | Field                                 | Type                                                | Description                                                                                                                                                                          |
  | ------------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | `name`                                | `string`                                            | The name of the project.                                                                                                                                                             |
  | `description`                         | `string`                                            | The description for the project.                                                                                                                                                     |
  | `content`                             | `string`                                            | The project content as markdown.                                                                                                                                                     |
  | `statusId`                            | `string`                                            | The ID of the project status. Use `project_statuses_list` to resolve a name such as 'Completed' to its UUID. This is how a project is closed; there is no separate operation for it. |
  | `leadId`                              | `string`                                            | The identifier of the project lead.                                                                                                                                                  |
  | `memberIds`                           | `string`\[]                                         | The identifiers of the members of this project.                                                                                                                                      |
  | `teamIds`                             | `string`\[]                                         | The identifiers of the teams this project is associated with.                                                                                                                        |
  | `labelIds`                            | `string`\[]                                         | The identifiers of the project labels associated with this project.                                                                                                                  |
  | `priority`                            | `integer`                                           | The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low. <span className="field-constraints">≥ 0; ≤ 4</span>                                         |
  | `startDate`                           | `string`                                            | The planned start date of the project, as `YYYY-MM-DD`.                                                                                                                              |
  | `startDateResolution`                 | [DateResolutionType](#dateresolutiontype)           | The resolution of the project's start date.                                                                                                                                          |
  | `targetDate`                          | `string`                                            | The planned target date of the project, as `YYYY-MM-DD`.                                                                                                                             |
  | `targetDateResolution`                | [DateResolutionType](#dateresolutiontype)           | The resolution of the project's estimated completion date.                                                                                                                           |
  | `completedAt`                         | `string`                                            | The time at which the project was moved into completed state.                                                                                                                        |
  | `canceledAt`                          | `string`                                            | The time at which the project was moved into canceled state.                                                                                                                         |
  | `icon`                                | `string`                                            | The icon of the project.                                                                                                                                                             |
  | `color`                               | `string`                                            | The color of the project, as a hex string.                                                                                                                                           |
  | `trashed`                             | `boolean`                                           | Whether the project has been trashed.                                                                                                                                                |
  | `convertedFromIssueId`                | `string`                                            | The ID of the issue from which that project is created.                                                                                                                              |
  | `lastAppliedTemplateId`               | `string`                                            | The ID of the last template applied to the project.                                                                                                                                  |
  | `sortOrder`                           | `number`                                            | The sort order for the project in shared views.                                                                                                                                      |
  | `prioritySortOrder`                   | `number`                                            | The sort order for the project within shared views, when ordered by priority.                                                                                                        |
  | `slackNewIssue`                       | `boolean`                                           | Whether to send new issue notifications to Slack.                                                                                                                                    |
  | `slackIssueComments`                  | `boolean`                                           | Whether to send new issue comment notifications to Slack.                                                                                                                            |
  | `slackIssueStatuses`                  | `boolean`                                           | Whether to send issue status update notifications to Slack.                                                                                                                          |
  | `updateReminderFrequency`             | `number`                                            | The frequency at which to prompt for project updates. When not set, reminders are inherited from workspace settings.                                                                 |
  | `updateReminderFrequencyInWeeks`      | `number`                                            | The n-weekly frequency at which to prompt for project updates. When not set, reminders are inherited from workspace settings.                                                        |
  | `frequencyResolution`                 | [FrequencyResolutionType](#frequencyresolutiontype) | The resolution type for the update reminder frequency (e.g., weekly, biweekly).                                                                                                      |
  | `updateRemindersDay`                  | [Day](#day)                                         | The day of the week on which to prompt for project updates.                                                                                                                          |
  | `updateRemindersHour`                 | `integer`                                           | The hour of the day (0-23) at which to prompt for project updates. <span className="field-constraints">≥ 0; ≤ 23</span>                                                              |
  | `projectUpdateRemindersPausedUntilAt` | `string`                                            | The time until which project update reminders are paused, as an ISO 8601 timestamp. This schema cannot send null to resume reminders — absent means unchanged.                       |
</div>

## ProjectDeleteVariables

Variables for the `projectDelete` mutation.

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

## ProjectUnarchiveVariables

Variables for the `projectUnarchive` mutation.

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

## ProjectLabelLinkVariables

Variables for `projectAddLabel` and `projectRemoveLabel`.

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

## PageVariables

The Relay pagination arguments every Linear connection accepts.

<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.                                                      |
</div>

## ProjectMilestonesListVariables

Variables for the `projectMilestones` 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`          | [ProjectMilestoneFilter](#projectmilestonefilter)                              | Narrow the milestones returned, usually to one project.                                                                           |
  | `includeArchived` | `boolean`                                                                      | Include archived milestones in the results.                                                                                       |
  | `orderBy`         | [PaginationOrderBy](/charter/charter/packs/linear/workspace/objects#paginationorderby) | Sort by 'createdAt' or 'updatedAt'.                                                                                               |
</div>

## ProjectMilestoneGetVariables

Variables for the `projectMilestone` query.

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

## ProjectMilestoneCreateVariables

Variables for the `projectMilestoneCreate` mutation.

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

## ProjectMilestoneCreateInput

The input to `projectMilestoneCreate`.

<div className="reference-table">
  | Field                                                             | Type     | Description                                                                           |
  | ----------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------- |
  | `name` <span className="required" title="required">\*</span>      | `string` | The name of the project milestone.                                                    |
  | `projectId` <span className="required" title="required">\*</span> | `string` | Related project for the project milestone.                                            |
  | `description`                                                     | `string` | The description of the project milestone.                                             |
  | `targetDate`                                                      | `string` | The planned target date of the project milestone, as `YYYY-MM-DD`.                    |
  | `sortOrder`                                                       | `number` | The sort order for the project milestone within a project.                            |
  | `id`                                                              | `string` | The identifier in UUID v4 format. If none is provided, the backend will generate one. |
</div>

## ProjectMilestoneUpdateVariables

Variables for the `projectMilestoneUpdate` mutation.

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

## ProjectMilestoneUpdateInput

The fields `projectMilestoneUpdate` changes. All optional.

<div className="reference-table">
  | Field         | Type     | Description                                                        |
  | ------------- | -------- | ------------------------------------------------------------------ |
  | `name`        | `string` | The name of the project milestone.                                 |
  | `description` | `string` | The description of the project milestone.                          |
  | `projectId`   | `string` | Related project for the project milestone.                         |
  | `targetDate`  | `string` | The planned target date of the project milestone, as `YYYY-MM-DD`. |
  | `sortOrder`   | `number` | The sort order for the project milestone within a project.         |
</div>

## ProjectMilestoneDeleteVariables

Variables for the `projectMilestoneDelete` mutation.

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

## ProjectUpdatesListVariables

Variables for the `projectUpdates` 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`          | [ProjectUpdateFilter](#projectupdatefilter)                                    | Narrow the updates returned, usually to one project.                                                                              |
  | `includeArchived` | `boolean`                                                                      | Include archived updates in the results.                                                                                          |
  | `orderBy`         | [PaginationOrderBy](/charter/charter/packs/linear/workspace/objects#paginationorderby) | Sort by 'createdAt' or 'updatedAt'.                                                                                               |
</div>

## ProjectUpdateFilter

A filter over project status updates.

<div className="reference-table">
  | Field       | Type                                                                     | Description                                  |
  | ----------- | ------------------------------------------------------------------------ | -------------------------------------------- |
  | `id`        | [IdComparator](/charter/charter/packs/linear/workspace/objects#idcomparator)     | Filter by update UUID.                       |
  | `user`      | [UserFilter](/charter/charter/packs/linear/workspace/objects#userfilter)         | Filter by who posted the update.             |
  | `project`   | [ProjectFilter](#projectfilter)                                          | Filter by the project the update belongs to. |
  | `createdAt` | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator) | Filter by when the update was posted.        |
  | `updatedAt` | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator) | Filter by when the update was last edited.   |
</div>

## ProjectUpdateGetVariables

Variables for the `projectUpdate` *query*.

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

## ProjectUpdateCreateVariables

Variables for the `projectUpdateCreate` mutation.

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

## ProjectUpdateCreateInput

The input to `projectUpdateCreate` — a status post on a project.

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

## ProjectUpdateUpdateVariables

Variables for the `projectUpdateUpdate` mutation.

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

## ProjectUpdateUpdateInput

The fields `projectUpdateUpdate` changes. All optional.

<div className="reference-table">
  | Field    | Type                            | Description                                           |
  | -------- | ------------------------------- | ----------------------------------------------------- |
  | `body`   | `string`                        | The content of the project update in markdown format. |
  | `health` | [ProjectHealth](#projecthealth) | The health of the project at the time of the update.  |
</div>

## ProjectUpdateArchiveVariables

Variables for the `projectUpdateArchive` mutation.

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

## DateResolutionType

<div className="enum-table">
  | Value      |
  | ---------- |
  | `halfYear` |
  | `month`    |
  | `quarter`  |
  | `year`     |
</div>

## ProjectHealth

<div className="enum-table">
  | Value      |
  | ---------- |
  | `onTrack`  |
  | `atRisk`   |
  | `offTrack` |
</div>

## Day

<div className="enum-table">
  | Value       |
  | ----------- |
  | `Monday`    |
  | `Tuesday`   |
  | `Wednesday` |
  | `Thursday`  |
  | `Friday`    |
  | `Saturday`  |
  | `Sunday`    |
</div>

## FrequencyResolutionType

<div className="enum-table">
  | Value    |
  | -------- |
  | `daily`  |
  | `weekly` |
</div>