Linear: Update Issue

Description

Update an existing Linear issue's title, description, priority, workflow state, or assignee. This action enables automated issue updates during incident lifecycle changes, allowing teams to keep Linear issues synchronized with incident status, reassign work based on escalations, or update issue details as new information becomes available.

Instructions

Inputs

NameDescription
IntegrationSelect your Linear connection. If you have not yet configured a Linear integration, please see the Linear Integration instructions.
Team
(optional)
Select the issue's team to filter Issue ID, State, and Assignee dropdown options. Team selection helps narrow down available options but is not required if you provide the Issue ID directly.
Issue IDThe Linear issue to update. Accepts three formats: (1) UUID (e.g., c1a0c51b-...), (2) identifier (e.g., PAG-22), or (3) select from dropdown after choosing a Team.
Title
(optional)
Title for the issue (max 255 characters). Only updates if provided.
Description
(optional)
New description for the issue in Markdown format (max 10,000 characters). Only updates if provided. Supports full Markdown syntax.
Priority
(optional)
Issue priority level. Options: 0 (No priority), 1 (Urgent), 2 (High), 3 (Medium), 4 (Low). Default is 0.
State
(optional)
New workflow state for the issue. Select from dropdown (requires Team selection) or provide a state name (e.g., "In Progress") or UUID. Only updates if provided.
Assignee
(optional)
New assignee for the issue. Select from dropdown (requires Team selection), provide an email, display name, or UUID. Use "unassign" to remove the current assignee. Only updates if provided.
Label
(optional)
Label to set on the issue. Select from dropdown or provide a label name or UUID. Only updates if provided.
📘

Minimum One Optional Field Required

You must provide at least one field to update (Title, Description, Priority, State, Assignee, or Label). The action will fail if no update fields are specified.

Outputs

NameDescription
Issue IDThe unique UUID identifier of the created Linear issue. Use this in subsequent actions that require an issue ID.
Issue URLDirect URL to view the issue in Linear. Useful for including in notifications or follow-up communications.
Issue IdentifierThe human-readable identifier for the issue in the format [TEAM]-[NUMBER] (e.g., ENG-123).
ResultStatus of the action execution. Returns Success or Failed.
Result SummaryBrief description of the action result, such as Issue created successfully: ENG-123 or error details if the action failed.
ErrorError message if the action failed. Empty if successful.

Examples

Update Issue State When Incident Resolves

Automatically mark a Linear issue as "Done" when the incident resolves:

  • Issue ID: {{steps.create-linear-issue.Issue ID}} (from a previous Create Issue step)
  • State: Done

This workflow step should be triggered on incident resolution.