📘
Availability
This workflow action is available on Business and Enterprise for Incident Management pricing plans. Contact the Sales Team to upgrade to an account with this action.

Description

Update the workflow state of an existing issue in Linear from a PagerDuty Incident Workflow. This action enables automated lifecycle management of Linear issues, allowing teams to advance or update issue status in response to incident milestones such as acknowledgment, escalation, or resolution.

Instructions

If you have not done so, follow the instructions to Create an Incident Workflow.
When the instructions prompt you to add actions, select this action.
Enter the following Inputs and click Save.
Continue following instructions to Publish the Workflow.
When the action runs, you will see the Outputs listed below.

Inputs

📘
Field References
Fields with the {+} icon accept Field References, which can be useful for referencing incident data or outputs created in prior workflow steps. To add Field References, click {+}, or enter {{, and select relevant fields. Refer to the Field References article for more information.

Name	Description
Issue ID	The unique identifier of the Linear issue to update. Example: `ENG-123` or a UUID.
State	The name of the workflow state to set on the issue. Must match an existing state in the Linear team's workflow. Example: `In Progress`, `Done`, `Cancelled`.

🚧
Note
Workflow states in Linear are team-specific. Ensure the state name you provide matches the exact state name configured for the team that owns the issue. Common states include In Progress, Done, Cancelled, and In Review.

Outputs

Name	Description
Issue ID	The unique identifier of the updated Linear issue.
Issue URL	A direct link to the updated issue in Linear. Use this in notifications or subsequent steps.