Linear

Deprecated base64-encoded file content to upload

MIME type for the upload (e.g., 'image/png', 'application/pdf')

Filename for the upload (e.g., 'screenshot.png')

Issue ID or identifier (e.g., LIN-123)

Expected SHA-256 hex digest of the decoded file bytes.

Optional expected decoded file size in bytes. Rejects the upload if it does not match.

Optional subtitle for the attachment

Optional title for the attachment

Linear upload assetUrl returned by prepare_attachment_upload

Issue ID or identifier (e.g., LIN-123)

Optional attachment subtitle

Attachment title. Defaults to filename or asset URL

Document title

Hex color

Content as Markdown

Icon emoji

Issue ID or identifier (e.g., LIN-123)

Project name, ID, or slug

Label name

Hex color code

Label description

Whether the label is a group

Parent label group name or ID

Label name

Hex color code

Label description

Whether the label is a group

Parent label group name or ID

Team UUID (omit for workspace label)

Attachment ID

Comment ID

Customer ID

Customer need ID

Submitted diff comment ID to delete

Persisted diff comment draft ID to delete

Status update ID

Type of status update

Markdown content containing image references (e.g., issue description, comment body)

Entity-prefixed ID returned by `search`, like `issue:LIN-123`

Agent skill ID

Attachment ID

Linear review URL, diff slug, pull request ID, Linear full identifier, or GitHub PR URL

Linear review URL, diff slug, pull request ID, Linear full identifier, or GitHub PR URL

Sort: createdAt | updatedAt

Filter returned threads by resolved state

Optional Linear comment UUID of any comment in the thread (not its `externalThreadId`); a reply's UUID resolves to its thread root

Document ID or slug

Initiative name, ID, identifier (e.g., INIT-123), or slug

Include projects

Include sub-initiatives

Issue ID or identifier (e.g., LIN-123)

Include associated customer needs

Include blocking/related/duplicate relations

Include associated releases

Status ID

Status name

Team name or ID

Project name, ID, identifier (e.g., PROJ-123), or slug

Milestone name or ID

Next page cursor

Max results (default 50, max 250)

Only return unread notifications

Project name, ID, identifier (e.g., PROJ-123), or slug

Include project members

Include milestones

Include resources (documents, links, attachments)

Release ID or slug

Include associated release notes

Release notes ID or slug

Include associated releases

Type of status update

Created after: ISO-8601 date/duration (e.g., -P1D)

Next page cursor

Status update ID - if provided, returns this specific update

Include archived items

Initiative name, ID, identifier (e.g., INIT-123), or slug

Max results (default 50, max 250)

Sort: createdAt | updatedAt

Project name, ID, identifier (e.g., PROJ-123), or slug

Updated after: ISO-8601 date/duration (e.g., -P1D)

User ID, name, email, or "me"

Team UUID, key, or name

Template ID or name

User ID, name, email, or "me"

Next page cursor

Max results (default 50, max 250)

Sort: createdAt | updatedAt

Next page cursor

Document ID or slug (provide exactly one parent)

Initiative name, ID, identifier (e.g., INIT-123), or slug (provide exactly one parent)

Issue ID or identifier (e.g., LIN-123) (provide exactly one parent)

Max results (default 50, max 250)

Milestone UUID (provide exactly one parent). Resolve milestone names via `list_milestones` first.

Sort: createdAt | updatedAt

Project name, ID, identifier (e.g., PROJ-123), or slug (provide exactly one parent)

Status update UUID (provide exactly one parent). Resolve status updates via `get_status_updates` first.

Type of status update named by `statusUpdateId`, as returned by `get_status_updates`. Only valid together with `statusUpdateId`; omit to check both project and initiative status updates.

Created after: ISO-8601 date/duration (e.g., -P1D)

Next page cursor

Include archived items

Include associated customer needs

Max results (default 50, max 250)

Sort: createdAt | updatedAt

User ID, name, email, or "me"

Search customer name

Customer status name or ID

Customer tier name or ID

Updated after: ISO-8601 date/duration (e.g., -P1D)

Team ID

Filter: current, previous, next, or all

Filter by author ID, name, email, or "me"

Next page cursor

Max results (default 50, max 250)

Sort: createdAt | updatedAt

Filter returned diffs by repository owner

Broad search by title, branch, PR number, or bare slug

Filter returned diffs by repository name

Filter by reviewer ID, name, email, or "me"

Reviewer state; requires reviewer and defaults to pending when reviewer is set

Filter returned diffs by pull request status

Created after: ISO-8601 date/duration (e.g., -P1D)

Filter by creator ID

Next page cursor

Fields to include in each result. `id` is always included. Omit or pass an empty array for the default response.

Include archived items

Filter by initiative ID

Max results (default 50, max 250)

Sort: createdAt | updatedAt

Filter by project ID

Search query

Filter by team ID

Updated after: ISO-8601 date/duration (e.g., -P1D)

Next page cursor

Max results (default 50, max 250)

Filter by name

Sort: createdAt | updatedAt

Created after: ISO-8601 date/duration (e.g., -P1D)

Next page cursor

Fields to include in each result. `id` is always included. Omit or pass an empty array for the default response.

Include archived items

Include projects

Include sub-initiatives

Label name or ID

Lead team name, key, or ID

Max results (default 50, max 250)

Sort: createdAt | updatedAt

User ID, name, email, or "me"

Parent initiative. Initiative name, ID, identifier (e.g., INIT-123), or slug

Search initiative name

Status of the initiative

Updated after: ISO-8601 date/duration (e.g., -P1D)

Next page cursor

Max results (default 50, max 250)

Filter by name

Sort: createdAt | updatedAt

Team name or ID

Team name or ID

User ID, name, email, or "me"

Created after: ISO-8601 date/duration (e.g., -P1D)

Next page cursor

Cycle name, number, or ID

Agent name or ID. When the user asks to delegate to "Linear" or "the Linear agent", this refers to the "Linear" app user specifically

Fields to include in each result. `id` is always included. Omit or pass an empty array for the default response.

Include archived items

Label name or ID

Max results (default 50, max 250)

Sort: createdAt | updatedAt

Parent issue ID or identifier (e.g., LIN-123)

0=None, 1=Urgent, 2=High, 3=Medium, 4=Low

Project name, ID, identifier (e.g., PROJ-123), or slug

Search issue title or description

Release ID or slug

State type, name, or ID

Team name or ID

Updated after: ISO-8601 date/duration (e.g., -P1D)

Project name, ID, identifier (e.g., PROJ-123), or slug

Next page cursor

Max results (default 50, max 250)

Filter by name

Sort: createdAt | updatedAt

Created after: ISO-8601 date/duration (e.g., -P1D)

Next page cursor

Fields to include in each result. `id` is always included. Omit or pass an empty array for the default response.

Include archived items

Include project members

Include milestones

Initiative name, ID, identifier (e.g., INIT-123), or slug

Label name or ID

Max results (default 50, max 50)

User ID, name, email, or "me"

Sort: createdAt | updatedAt

Search project name

State type, name, or ID

Team name or ID

Updated after: ISO-8601 date/duration (e.g., -P1D)

Created after: ISO-8601 date/duration (e.g., -P1D)

Next page cursor

Include archived items

Include markdown release notes content

Include associated releases

Max results (default 50, max 250)

Sort: createdAt | updatedAt

Release pipeline ID, slug, or exact name

Search release notes title

Release ID or slug

Updated after: ISO-8601 date/duration (e.g., -P1D)

Created after: ISO-8601 date/duration (e.g., -P1D)

Next page cursor

Include archived items

Include each pipeline's stages

Include each pipeline's teams

Filter by production pipeline flag

Max results (default 50, max 250)

Sort: createdAt | updatedAt

Search pipeline name

Team name or ID

Pipeline type: continuous | scheduled

Updated after: ISO-8601 date/duration (e.g., -P1D)

Created after: ISO-8601 date/duration (e.g., -P1D)

Next page cursor

Filter to releases that do (true) or do not (false) have release notes

Include archived items

Include associated release notes

Max results (default 50, max 250)

Sort: createdAt | updatedAt

Release pipeline ID, slug, or exact name

Search release name or version

Release stage ID or exact name

Filter by stage lifecycle type

Updated after: ISO-8601 date/duration (e.g., -P1D)

Exact version match

Created after: ISO-8601 date/duration (e.g., -P1D)

Next page cursor

Include archived items

Max results (default 50, max 250)

Sort: createdAt | updatedAt

Search query

Updated after: ISO-8601 date/duration (e.g., -P1D)

Team name or ID. Returns that team's templates plus workspace-level ones

Filter by template type. Omit to return every type

Next page cursor

Max results (default 50, max 250)

Sort: createdAt | updatedAt

Filter by name or email

Team name or ID

Notification ID

Whether the notification should be marked as read

ISO-8601 time to snooze until, or null to unsnooze

Linear review URL, diff slug, pull request ID, Linear full identifier, or GitHub PR URL

Merge method; omit to use the repository default

MIME type, e.g. image/png or application/pdf

Filename for the upload, e.g. screenshot.png

Issue ID or identifier (e.g., LIN-123)

Exact file size in bytes. Must be smaller than 2 GB.

Suggested attachment subtitle for the finalize step

Suggested attachment title for the finalize step

A natural-language request or question for Linear, e.g. "list my high-priority issues", "what shipped this week?", or "create a bug for the search team"

Conversation ID for multi-turn conversations

Top-level diff thread/comment ID

True to resolve the thread; false to reopen it

Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)

Document ID or slug (provide exactly one parent)

Comment ID. If provided, updates the existing comment

Initiative name, ID, identifier (e.g., INIT-123), or slug (provide exactly one parent)

Issue ID or identifier (e.g., LIN-123) (provide exactly one parent)

Milestone UUID (provide exactly one parent). Resolve milestone names via `list_milestones` first.

Parent comment ID (for replies, only when creating)

Project name, ID, identifier (e.g., PROJ-123), or slug (provide exactly one parent)

Status update UUID (provide exactly one parent). Resolve status updates via `get_status_updates` first.

Type of status update named by `statusUpdateId`, as returned by `get_status_updates`. Only valid together with `statusUpdateId`; omit to check both project and initiative status updates.

Domains to add to this customer. Append-only; existing domains are never removed

External system IDs to add. Append-only; existing IDs are never removed

Customer ID. If provided, updates the existing customer

Customer name (required when creating)

User ID, name, email, or "me"

Annual revenue generated by the customer

Size of the customer organization

Customer status name or ID

Customer tier name or ID

Description of the customer need (required when creating)

Customer ID or name

Customer need ID. If provided, updates the existing need

Issue ID or identifier (e.g., LIN-123) to associate with this need

Whether the need is important. 0 = Not important, 1 = Important

Project name, ID, identifier (e.g., PROJ-123), or slug to associate with this need

URL to attach as the source for this customer need, such as a transcript or support thread

Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences

Optional comment anchor copied from a diff thread or built for a file or diff hunk

Exact source text of the anchor's end line; stored with an inline draft so it can be re-anchored after the diff receives new revisions

Existing comment ID to edit

Save as a private persisted draft without submitting

Existing persisted draft ID to edit or submit

Top-level comment ID to reply to; also required when submitting a persisted reply draft

Linear review URL, diff slug, pull request ID, Linear full identifier, or GitHub PR URL

Hex color

Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)

Cycle name, number, or ID. When passing a name or number, also pass `team` to disambiguate.

Icon name or emoji code (e.g. "Rocket" or ":eagle:"), not a raw Unicode emoji

Document ID or slug to update. Omit to create a new document.

Initiative name, ID, identifier (e.g., INIT-123), or slug

Issue ID or identifier (e.g., LIN-123)

Partial edits applied to the current content, in order and atomically (one failing operation aborts the whole save). Every anchor string must match the current content exactly once. Only valid on update, in place of the full content/description field

Project name, ID, identifier (e.g., PROJ-123), or slug

Team name or ID. Attaches the document to the team, unless `cycle` is also passed, in which case it disambiguates the cycle.

Document title (required when creating)

Hex color

Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)

Icon name or emoji code (e.g. "Rocket" or ":eagle:"), not a raw Unicode emoji

Initiative name, ID, identifier (e.g., INIT-123), or slug. If provided, updates the existing initiative

Label names or IDs as a JSON array of strings (e.g. ["Bug", "Urgent"]). Replaces the full label set; existing labels not included are removed. Omit to leave labels unchanged

Lead team name, key, or ID. Null to remove the lead team

Initiative name (required when creating)

User ID, name, email, or "me". Null to remove

Parent initiatives to add. Initiative name, ID, identifier (e.g., INIT-123), or slug. Appended to existing parents

Partial edits applied to the current content, in order and atomically (one failing operation aborts the whole save). Every anchor string must match the current content exactly once. Only valid on update, in place of the full content/description field

0=None, 1=Urgent, 2=High, 3=Medium, 4=Low

Initiative status (Proposed, Planned, Active, Completed, Canceled)

Short summary (max 255 chars)

Target date (ISO format)

Hex color code

Label description. Null to clear it

Label name or ID. If provided, updates the existing label

Whether the label is a group

Label name (required when creating)

Parent label group name or ID. Null to remove from its group

Label names or IDs as a JSON array of strings (e.g. ["Bug", "Urgent"]) to add. Append-only; existing labels are never removed. Cannot be combined with a team change

Release IDs or slugs to add. Append-only; existing releases are never removed

User ID, name, email, or "me". Null to remove

Issue IDs/identifiers blocking this. Append-only; existing relations are never removed

Issue IDs/identifiers this blocks. Append-only; existing relations are never removed

Cycle name, number, or ID. Null to remove

Agent name or ID. When the user asks to delegate to "Linear" or "the Linear agent", this refers to the "Linear" app user specifically. Null to remove

Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)

Due date (ISO format). On update, pass null to remove the due date

Duplicate of issue ID/identifier. Null to remove

Issue estimate value. On create, pass null or omit for no estimate. On update, pass null to clear the estimate; omitting leaves it unchanged. 0 is a real estimate only on teams that allow zero estimates.

Only for updating an existing issue. Pass the issue ID or identifier (e.g., LIN-123). Do NOT pass this parameter when creating a new issue.

Label names or IDs as a JSON array of strings (e.g. ["Bug", "Urgent"]). Replaces the full label set; existing labels not included are removed. Omit to leave labels unchanged. Cannot be combined with addLabels/removeLabels; prefer those for incremental changes

Link attachments to add [{url, title}]. Append-only; existing links are never removed

Milestone name or ID

Parent issue ID or identifier (e.g., LIN-123). Null to remove

Partial edits applied to the current content, in order and atomically (one failing operation aborts the whole save). Every anchor string must match the current content exactly once. Only valid on update, in place of the full content/description field

0=None, 1=Urgent, 2=High, 3=Medium, 4=Low

Project name, ID, identifier (e.g., PROJ-123), or slug. Null to remove

Related issue IDs/identifiers. Append-only; existing relations are never removed

Issue IDs/identifiers to remove as blockers of this issue

Issue IDs/identifiers to stop blocking

Label names or IDs as a JSON array of strings (e.g. ["Bug", "Urgent"]) to remove. Only valid when updating an existing issue. Cannot be combined with a team change

Related issue IDs/identifiers to remove

Release IDs or slugs to remove. Only valid when updating an existing issue

Replace all releases on the issue with these. Cannot be combined with addReleases/removeReleases

ISO-8601 timestamp when the SLA will breach. On update, pass null to remove the SLA

SLA day counting type: "all" or "onlyBusinessDays". Only use with slaBreachesAt; null means unset

State type, name, or ID

Team name or ID (required when creating)

Template name or ID. Applied on create only. The template fills in the content, fields, and sub-issues server-side. A `description` replaces the template body rather than merging with it, but an empty `description` keeps the template body. Labels merge with the template's own

Issue title (required when creating, unless template is set)

Hex color code

Label description. Null to clear it

Label name or ID. If provided, updates the existing label

Whether the label is a group

Label name (required when creating)

Parent label group name or ID. Null to remove from its group

Team UUID (omit for workspace label). When updating, only disambiguates `id` by name; a label's team cannot be changed

Project name, ID, identifier (e.g., PROJ-123), or slug

Milestone description

Milestone name or ID

Milestone name (required when creating)

Target completion date (ISO format, null to remove)

Initiatives to add. Initiative name, ID, identifier (e.g., INIT-123), or slug

Team name or ID to add

Hex color

Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)

Icon name or emoji code (e.g. "Rocket" or ":eagle:"), not a raw Unicode emoji

Project name, ID, identifier (e.g., PROJ-123), or slug. If provided, updates the existing project

Label names or IDs as a JSON array of strings (e.g. ["Bug", "Urgent"]). Replaces the full label set; existing labels not included are removed. Omit to leave labels unchanged

User ID, name, email, or "me". Null to remove, except on create with a template that names a lead

External resource links to add [{url, title}]. Append-only; existing links are never removed

Project name (required when creating)

Partial edits applied to the current content, in order and atomically (one failing operation aborts the whole save). Every anchor string must match the current content exactly once. Only valid on update, in place of the full content/description field

0=None, 1=Urgent, 2=High, 3=Medium, 4=Low

Initiatives to remove. Initiative name, ID, identifier (e.g., INIT-123), or slug

Team name or ID to remove

Replace all initiatives with these. Initiative name, ID, identifier (e.g., INIT-123), or slug. Cannot combine with addInitiatives/removeInitiatives

Replace all teams with these. Cannot combine with addTeams/removeTeams

Start date (ISO format). Pair with startDateResolution to indicate precision (e.g. month, quarter)

Start date resolution

Project state

Short summary (max 255 chars)

Target date (ISO format). Pair with targetDateResolution to indicate precision (e.g. month, quarter)

Target date resolution

Template name or ID. Applied on create only. The template fills in the content, fields, and sub-issues server-side. A `description` replaces the template body rather than merging with it, but an empty `description` keeps the template body. Labels merge with the template's own

Hex color code

Label description. Null to clear it

Label name or ID. If provided, updates the existing label

Whether the label is a group

Label name (required when creating)

Parent label group name or ID. Null to remove from its group

Commit SHA associated with the release

Completed timestamp (ISO DateTime, null to remove)

Import/create timestamp (ISO DateTime)

Release description

Release ID or slug to update. Omit to create a new release.

Release name (required when creating)

Release pipeline ID, slug, or exact name (required when creating)

Release stage ID, exact name, or lifecycle type within the release pipeline

Estimated start date (ISO YYYY-MM-DD, null to remove)

Started timestamp (ISO DateTime, null to remove)

Estimated completion date (ISO YYYY-MM-DD, null to remove)

Version identifier

Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)

Release notes ID or slug to update. Omit to create new release notes.

Partial edits applied to the current content, in order and atomically (one failing operation aborts the whole save). Every anchor string must match the current content exactly once. Only valid on update, in place of the full content/description field

Release pipeline ID, slug, or exact name (required when creating)

Oldest release ID or slug in the note range

Newest release ID or slug in the note range

Release IDs or slugs to include in the note

Release notes title

Type of status update

Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)

onTrack | atRisk | offTrack

Status update ID - if provided, updates this existing update

Initiative name, ID, identifier (e.g., INIT-123), or slug

Deprecated. Hide diff with previous update (create only)

Project name, ID, identifier (e.g., PROJ-123), or slug

Natural language or keyword search terms (e.g. "billing webhook failure"). Supports "quoted phrases" for exact match, -term for exclusion, and +term for required terms

Include archived items

Max results (default 10, max 50)

Optional entity type filter

Search query

Page number

Issue ID or identifier (e.g., LIN-123)

User ID, name, email, or "me" Must be an email address or UUID.

Review decision: approved, changesRequested, or commented

Linear review URL, diff slug, pull request ID, Linear full identifier, or GitHub PR URL

Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. Required when requesting changes or commenting

Issue ID or identifier (e.g., LIN-123)

User ID, name, email, or "me" Must be an email address or UUID.

Document ID or slug

Hex color

Content as Markdown

Icon emoji

Project name, ID, or slug

Document title