TOOL API

save_issue

Create or update a Linear issue. If `id` is provided, updates the existing issue; otherwise creates a new one. When creating, `title` and `team` are required. Note: use `assignee` (not `assigneeId`) to set the assignee — it accepts a user ID, name, email, or "me".

devOAuth1 credits

Call information

Tool slug: linear.save_issue
Provider: Linear
Average response: 0 ms
Calls in 7 days: 0

Input parameters

id

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.

title

Issue title (required when creating)

description

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

team

Team name or ID (required when creating)

cycle

Cycle name, number, or ID

milestone

Milestone name or ID

priority

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

project

Project name, ID, or slug

state

State type, name, or ID

assignee

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

delegate

Agent name or ID. Null to remove

labels

Label names or IDs

dueDate

Due date (ISO format)

parentId

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

estimate

Issue estimate value

links

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

blocks

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

blockedBy

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

relatedTo

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

duplicateOf

Duplicate of issue ID/identifier. Null to remove

removeBlocks

Issue IDs/identifiers to stop blocking

removeBlockedBy

Issue IDs/identifiers to remove as blockers of this issue

removeRelatedTo

Related issue IDs/identifiers to remove