Objects

Field	Type	Description
`first`	`integer`	How many results to return. Linear returns 50 by default. ≥ 1; ≤ 250; defaults to `50`
`after`	`string`	The `endCursor` from the previous page’s `pageInfo`, to fetch the next page.
`filter`	ProjectFilter	Narrow the projects returned.
`includeArchived`	`boolean`	Include archived projects in the results.
`orderBy`	PaginationOrderBy	Sort by ‘createdAt’ or ‘updatedAt’.

ProjectFilter

A filter over projects, or over an issue’s project.

Field	Type	Description
`id`	IdComparator	Filter by project UUID.
`name`	StringComparator	Filter by project name.
`slugId`	StringComparator	Filter by the project’s slug.
`priority`	NullableNumberComparator	Filter by the project’s priority.
`health`	StringComparator	Filter by the project’s health: ‘onTrack’, ‘atRisk’ or ‘offTrack’.
`state`	StringComparator	Filter by the project’s state, such as ‘planned’, ‘started’, ‘completed’ or ‘canceled’.
`startDate`	NullableDateComparator	Filter by the project’s start date.
`targetDate`	NullableDateComparator	Filter by the project’s target date.
`completedAt`	NullableDateComparator	Filter by when the project was completed.
`canceledAt`	NullableDateComparator	Filter by when the project was canceled.
`createdAt`	DateComparator	Filter by when the project was created.
`updatedAt`	DateComparator	Filter by when the project was last updated.
`lead`	UserFilter	Filter by the project’s lead.
`creator`	UserFilter	Filter by who created the project.
`startedAt`	NullableDateComparator	Comparator for the project started date (when it was moved to an “In Progress” status).
`activityType`	StringComparator	Comparator for the project activity type: buzzin, active, some, none.
`healthWithAge`	StringComparator	Comparator for the project health (with age): onTrack, atRisk, offTrack, outdated, noUpdate.
`customerCount`	NumberComparator	Count of customers.
`customerImportantCount`	NumberComparator	Count of important customers.
`hasBlockedByRelations`	RelationExistsComparator	Comparator for filtering projects which are blocked.
`hasBlockingRelations`	RelationExistsComparator	Comparator for filtering projects which are blocking.
`hasRelatedRelations`	RelationExistsComparator	Comparator for filtering projects with relations.
`hasViolatedRelations`	RelationExistsComparator	Comparator for filtering projects with violated dependencies.
`status`	ProjectStatusFilter	Filters that the project status must satisfy.
`leadTeam`	TeamFilter	Filters that the project’s lead team must satisfy.
`lastAppliedTemplate`	TemplateFilter	Filters that the last applied template must satisfy.
`nextProjectMilestone`	ProjectMilestoneFilter	Filters that the project’s next milestone must satisfy.
`labels`	ProjectLabelCollectionFilter	Filters that project labels must satisfy.

ProjectStatusFilter

A filter over project statuses.

Field	Type	Description
`id`	IdComparator	Comparator for the identifier.
`name`	StringComparator	Comparator for the project status name.
`type`	StringComparator	Comparator for the project status type.

TemplateFilter

A filter over templates.

Field	Type	Description
`id`	IdComparator	Filter by template UUID.
`name`	StringComparator	Filter by name.
`type`	StringComparator	Comparator for the template’s type.

ProjectMilestoneFilter

A filter over project milestones.

Field	Type	Description
`id`	IdComparator	Filter by milestone UUID.
`name`	StringComparator	Filter by name.
`targetDate`	NullableDateComparator	Filter by the milestone’s target date.
`createdAt`	DateComparator	Filter by when the milestone was created.
`updatedAt`	DateComparator	Filter by when the milestone was last updated.
`project`	ProjectFilter	Filters that the project milestone’s project must satisfy.

ProjectLabelCollectionFilter

ProjectLabelFilter plus collection operators.

Field	Type	Description
`id`	IdComparator	Comparator for the identifier.
`name`	StringComparator	Comparator for the name.

ProjectGetVariables

Variables for the project query.

Field	Type	Description
`id` *	`string`	The project’s UUID, or the slug from its URL.

ProjectCreateVariables

Variables for the projectCreate mutation.

Field	Type	Description
`input` *	ProjectCreateInput	The project to create.

ProjectCreateInput

The input to projectCreate.

Field	Type	Description
`name` *	`string`	The name of the project.
`teamIds` *	`string`[]	The identifiers of the teams this project is associated with. min 1 items
`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. ≥ 0; ≤ 4
`startDate`	`string`	The planned start date of the project, as `YYYY-MM-DD`.
`startDateResolution`	DateResolutionType	The resolution of the project’s start date.
`targetDate`	`string`	The planned target date of the project, as `YYYY-MM-DD`.
`targetDateResolution`	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.

ProjectUpdateVariables

Variables for the projectUpdate mutation.

Field	Type	Description
`id` *	`string`	The project’s UUID, or the slug from its URL.
`input` *	ProjectUpdateInput	The fields to change.

ProjectUpdateInput

The fields the projectUpdate mutation changes. All optional.

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. ≥ 0; ≤ 4
`startDate`	`string`	The planned start date of the project, as `YYYY-MM-DD`.
`startDateResolution`	DateResolutionType	The resolution of the project’s start date.
`targetDate`	`string`	The planned target date of the project, as `YYYY-MM-DD`.
`targetDateResolution`	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	The resolution type for the update reminder frequency (e.g., weekly, biweekly).
`updateRemindersDay`	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. ≥ 0; ≤ 23
`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.

ProjectDeleteVariables

Variables for the projectDelete mutation.

Field	Type	Description
`id` *	`string`	The project’s UUID.

ProjectUnarchiveVariables

Variables for the projectUnarchive mutation.

Field	Type	Description
`id` *	`string`	The project’s UUID.

ProjectLabelLinkVariables

Variables for projectAddLabel and projectRemoveLabel.

Field	Type	Description
`id` *	`string`	The project’s UUID.
`labelId` *	`string`	The project label’s UUID.

PageVariables

The Relay pagination arguments every Linear connection accepts.

Field	Type	Description
`first`	`integer`	How many results to return. Linear returns 50 by default. ≥ 1; ≤ 250; defaults to `50`
`after`	`string`	The `endCursor` from the previous page’s `pageInfo`, to fetch the next page.

ProjectMilestonesListVariables

Variables for the projectMilestones connection.

Field	Type	Description
`first`	`integer`	How many results to return. Linear returns 50 by default. ≥ 1; ≤ 250; defaults to `50`
`after`	`string`	The `endCursor` from the previous page’s `pageInfo`, to fetch the next page.
`filter`	ProjectMilestoneFilter	Narrow the milestones returned, usually to one project.
`includeArchived`	`boolean`	Include archived milestones in the results.
`orderBy`	PaginationOrderBy	Sort by ‘createdAt’ or ‘updatedAt’.

ProjectMilestoneGetVariables

Variables for the projectMilestone query.

Field	Type	Description
`id` *	`string`	The milestone’s UUID.

ProjectMilestoneCreateVariables

Variables for the projectMilestoneCreate mutation.

Field	Type	Description
`input` *	ProjectMilestoneCreateInput	The milestone to create.

ProjectMilestoneCreateInput

The input to projectMilestoneCreate.

Field	Type	Description
`name` *	`string`	The name of the project milestone.
`projectId` *	`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.

ProjectMilestoneUpdateVariables

Variables for the projectMilestoneUpdate mutation.

Field	Type	Description
`id` *	`string`	The milestone’s UUID.
`input` *	ProjectMilestoneUpdateInput	The fields to change.

ProjectMilestoneUpdateInput

The fields projectMilestoneUpdate changes. All optional.

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.

ProjectMilestoneDeleteVariables

Variables for the projectMilestoneDelete mutation.

Field	Type	Description
`id` *	`string`	The milestone’s UUID.

ProjectUpdatesListVariables

Variables for the projectUpdates connection.

Field	Type	Description
`first`	`integer`	How many results to return. Linear returns 50 by default. ≥ 1; ≤ 250; defaults to `50`
`after`	`string`	The `endCursor` from the previous page’s `pageInfo`, to fetch the next page.
`filter`	ProjectUpdateFilter	Narrow the updates returned, usually to one project.
`includeArchived`	`boolean`	Include archived updates in the results.
`orderBy`	PaginationOrderBy	Sort by ‘createdAt’ or ‘updatedAt’.

ProjectUpdateFilter

A filter over project status updates.

Field	Type	Description
`id`	IdComparator	Filter by update UUID.
`user`	UserFilter	Filter by who posted the update.
`project`	ProjectFilter	Filter by the project the update belongs to.
`createdAt`	DateComparator	Filter by when the update was posted.
`updatedAt`	DateComparator	Filter by when the update was last edited.

ProjectUpdateGetVariables

Variables for the projectUpdate query.

Field	Type	Description
`id` *	`string`	The status update’s UUID.

ProjectUpdateCreateVariables

Variables for the projectUpdateCreate mutation.

Field	Type	Description
`input` *	ProjectUpdateCreateInput	The status update to post.

ProjectUpdateCreateInput

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

Field	Type	Description
`projectId` *	`string`	The project to associate the project update with.
`body`	`string`	The content of the project update in markdown format.
`health`	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.

ProjectUpdateUpdateVariables

Variables for the projectUpdateUpdate mutation.

Field	Type	Description
`id` *	`string`	The status update’s UUID.
`input` *	ProjectUpdateUpdateInput	The fields to change.

ProjectUpdateUpdateInput

The fields projectUpdateUpdate changes. All optional.

Field	Type	Description
`body`	`string`	The content of the project update in markdown format.
`health`	ProjectHealth	The health of the project at the time of the update.

ProjectUpdateArchiveVariables

Variables for the projectUpdateArchive mutation.

Field	Type	Description
`id` *	`string`	The status update’s UUID.

DateResolutionType

Value
`halfYear`
`month`
`quarter`
`year`

ProjectHealth

Value
`onTrack`
`atRisk`
`offTrack`

Day

Value
`Monday`
`Tuesday`
`Wednesday`
`Thursday`
`Friday`
`Saturday`
`Sunday`

FrequencyResolutionType

Value
`daily`
`weekly`

OAuth packs

API-key packs

Model tree

ProjectsListVariables

ProjectFilter

ProjectStatusFilter

TemplateFilter

ProjectMilestoneFilter

ProjectLabelCollectionFilter

ProjectGetVariables

ProjectCreateVariables

ProjectCreateInput

ProjectUpdateVariables

ProjectUpdateInput

ProjectDeleteVariables

ProjectUnarchiveVariables

ProjectLabelLinkVariables

PageVariables

ProjectMilestonesListVariables

ProjectMilestoneGetVariables

ProjectMilestoneCreateVariables

ProjectMilestoneCreateInput

ProjectMilestoneUpdateVariables

ProjectMilestoneUpdateInput

ProjectMilestoneDeleteVariables

ProjectUpdatesListVariables

ProjectUpdateFilter

ProjectUpdateGetVariables

ProjectUpdateCreateVariables

ProjectUpdateCreateInput

ProjectUpdateUpdateVariables

ProjectUpdateUpdateInput

ProjectUpdateArchiveVariables

DateResolutionType

ProjectHealth

Day

FrequencyResolutionType

​Model tree

​ProjectsListVariables

​ProjectFilter

​ProjectStatusFilter

​TemplateFilter

​ProjectMilestoneFilter

​ProjectLabelCollectionFilter

​ProjectGetVariables

​ProjectCreateVariables

​ProjectCreateInput

​ProjectUpdateVariables

​ProjectUpdateInput

​ProjectDeleteVariables

​ProjectUnarchiveVariables

​ProjectLabelLinkVariables

​PageVariables

​ProjectMilestonesListVariables

​ProjectMilestoneGetVariables

​ProjectMilestoneCreateVariables

​ProjectMilestoneCreateInput

​ProjectMilestoneUpdateVariables

​ProjectMilestoneUpdateInput

​ProjectMilestoneDeleteVariables

​ProjectUpdatesListVariables

​ProjectUpdateFilter

​ProjectUpdateGetVariables

​ProjectUpdateCreateVariables

​ProjectUpdateCreateInput

​ProjectUpdateUpdateVariables

​ProjectUpdateUpdateInput

​ProjectUpdateArchiveVariables

​DateResolutionType

​ProjectHealth

​Day

​FrequencyResolutionType

Model tree

ProjectsListVariables

ProjectFilter

ProjectStatusFilter

TemplateFilter

ProjectMilestoneFilter

ProjectLabelCollectionFilter

ProjectGetVariables

ProjectCreateVariables

ProjectCreateInput

ProjectUpdateVariables

ProjectUpdateInput

ProjectDeleteVariables

ProjectUnarchiveVariables

ProjectLabelLinkVariables

PageVariables

ProjectMilestonesListVariables

ProjectMilestoneGetVariables

ProjectMilestoneCreateVariables

ProjectMilestoneCreateInput

ProjectMilestoneUpdateVariables

ProjectMilestoneUpdateInput

ProjectMilestoneDeleteVariables

ProjectUpdatesListVariables

ProjectUpdateFilter

ProjectUpdateGetVariables

ProjectUpdateCreateVariables

ProjectUpdateCreateInput

ProjectUpdateUpdateVariables

ProjectUpdateUpdateInput

ProjectUpdateArchiveVariables

DateResolutionType

ProjectHealth

Day

FrequencyResolutionType