# Linear: Update Issue - State

Advances an existing Linear issue to a different workflow state, such as acknowledged, escalated, or resolved, from an incident.


> **Availability:** See the [Incident Workflow Actions Overview table](/workflow-actions) for the plans this workflow is available on.

## 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

1. If you have not done so, follow the instructions to [Create an Incident Workflow](/ai-automation/automation/incident-workflows#create-an-incident-workflow).
2. When the instructions prompt you to [add actions](/ai-automation/automation/incident-workflows#add-actions), select **this action**.
3. Enter the following **Inputs** and click **Save**.
4. Continue following instructions to **Publish** the Workflow.
5. When the action runs, you will see the **Outputs** listed below.

## Inputs

> **Field References:** Fields with the **\{+\}** icon accept [Field References](/ai-automation/automation/incident-workflows#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](/ai-automation/automation/incident-workflows#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. |