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
| Name | Description |
|---|---|
| Integration | Select 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 ID | The 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 RequiredYou 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
| Name | Description |
|---|---|
| Issue ID | The unique UUID identifier of the created Linear issue. Use this in subsequent actions that require an issue ID. |
| Issue URL | Direct URL to view the issue in Linear. Useful for including in notifications or follow-up communications. |
| Issue Identifier | The human-readable identifier for the issue in the format [TEAM]-[NUMBER] (e.g., ENG-123). |
| Result | Status of the action execution. Returns Success or Failed. |
| Result Summary | Brief description of the action result, such as Issue created successfully: ENG-123 or error details if the action failed. |
| Error | Error 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.
Updated about 2 hours ago
