Linear issue actions

Linear integration actions let workflows manage issues and related content through your installed Linear integration.

Prerequisites

• A Linear integration installed in your Port organization.
• Actions processing enabled for the integration.
• A Linear API key with access to the teams, issues, projects, and agents used by the workflow.

Configuration

All Linear actions use the following node configuration:

Field	Type	Description
type	"INTEGRATION_ACTION"	Required. Must be "INTEGRATION_ACTION".
installationId	string	Required. Your Linear integration installation ID.
integrationProvider	"linear"	Required. Must be "linear".
integrationInvocationType	string	Required. The Linear operation to run.
integrationActionExecutionProperties	object	Required. Properties for the selected operation.

Create an issue

Use create_issue to create an issue in a Linear team.

Execution properties

Field	Type	Description
teamId	string	Required. UUID of the Linear team.
title	string	Required. Issue title.
description	string	Issue description in Markdown.
assigneeId	string	UUID of the user assigned to the issue.
stateId	string	UUID of the workflow state assigned to the issue.
projectId	string	UUID of the associated project.
cycleId	string	UUID of the associated cycle.
priority	string	Priority from 0 (no priority) to 4 (low).
labelIds	array	UUIDs of labels attached to the issue.

Example

Create an issue in a Linear team:

Node configuration (click to expand)

{
  "identifier": "create-linear-issue",
  "title": "Create Linear issue",
  "config": {
    "type": "INTEGRATION_ACTION",
    "installationId": "linear-installation",
    "integrationProvider": "linear",
    "integrationInvocationType": "create_issue",
    "integrationActionExecutionProperties": {
      "teamId": "4b28ca84-2f8f-4a52-8f31-2ccbbbd83091",
      "title": "Investigate checkout failures"
    }
  }
}

Create a sub-issue

Use create_sub_issue to create a child of an existing issue.

Execution properties

Field	Type	Description
parentId	string	Required. UUID or identifier of the parent issue, such as ENG-123.
title	string	Required. Sub-issue title.
teamId	string	Team UUID. The parent issue's team is used when omitted.
description	string	Issue description in Markdown.
assigneeId	string	UUID of the user assigned to the issue.
stateId	string	UUID of the workflow state assigned to the issue.
priority	string	Priority from 0 (no priority) to 4 (low).

Example

Create a sub-issue under an existing parent issue:

Node configuration (click to expand)

{
  "identifier": "create-linear-sub-issue",
  "title": "Create Linear sub-issue",
  "config": {
    "type": "INTEGRATION_ACTION",
    "installationId": "linear-installation",
    "integrationProvider": "linear",
    "integrationInvocationType": "create_sub_issue",
    "integrationActionExecutionProperties": {
      "parentId": "ENG-123",
      "title": "Add regression coverage"
    }
  }
}

Update an issue

Use update_issue to update an existing issue. Provide at least one optional field to change.

Execution properties

Field	Type	Description
issueId	string	Required. UUID or identifier of the issue, such as ENG-123.
title	string	Updated issue title.
description	string	Updated issue description in Markdown.
assigneeId	string	UUID of the user assigned to the issue.
stateId	string	UUID of the workflow state.
projectId	string	UUID of the associated project.
cycleId	string	UUID of the associated cycle.
priority	string	Priority from 0 (no priority) to 4 (low).
delegateId	string	UUID of the agent app user delegated to the issue.
labelIds	array	UUIDs of labels attached to the issue.

Example

Update an existing issue:

Node configuration (click to expand)

{
  "identifier": "update-linear-issue",
  "title": "Update Linear issue",
  "config": {
    "type": "INTEGRATION_ACTION",
    "installationId": "linear-installation",
    "integrationProvider": "linear",
    "integrationInvocationType": "update_issue",
    "integrationActionExecutionProperties": {
      "issueId": "ENG-123",
      "title": "Investigate intermittent checkout failures"
    }
  }
}

Change issue status

Use change_status to move an issue to another workflow state. Provide either stateId or stateName.

Execution properties

Field	Type	Description
issueId	string	Required. UUID or identifier of the issue.
stateId	string	UUID of the target workflow state.
stateName	string	Name of the target workflow state in the issue's team.

Example

Move an issue to another workflow state:

Node configuration (click to expand)

{
  "identifier": "change-linear-issue-status",
  "title": "Change Linear issue status",
  "config": {
    "type": "INTEGRATION_ACTION",
    "installationId": "linear-installation",
    "integrationProvider": "linear",
    "integrationInvocationType": "change_status",
    "integrationActionExecutionProperties": {
      "issueId": "ENG-123",
      "stateName": "In Progress"
    }
  }
}

Add a comment

Use add_comment to add Markdown content to an issue.

Execution properties

Field	Type	Description
issueId	string	Required. UUID or identifier of the issue.
body	string	Required. Comment content in Markdown.

Example

Post a comment on an issue:

Node configuration (click to expand)

{
  "identifier": "comment-on-linear-issue",
  "title": "Comment on Linear issue",
  "config": {
    "type": "INTEGRATION_ACTION",
    "installationId": "linear-installation",
    "integrationProvider": "linear",
    "integrationInvocationType": "add_comment",
    "integrationActionExecutionProperties": {
      "issueId": "ENG-123",
      "body": "The fix is ready for review."
    }
  }
}

Add a document

Use add_document to create a document associated with an issue or project. Provide either issueId or projectId.

Execution properties

Field	Type	Description
title	string	Required. Document title.
content	string	Document content in Markdown.
issueId	string	UUID or identifier of the related issue.
projectId	string	UUID of the related project.

Example

Create a document linked to an issue:

Node configuration (click to expand)

{
  "identifier": "add-linear-document",
  "title": "Add Linear document",
  "config": {
    "type": "INTEGRATION_ACTION",
    "installationId": "linear-installation",
    "integrationProvider": "linear",
    "integrationInvocationType": "add_document",
    "integrationActionExecutionProperties": {
      "title": "Checkout failure investigation",
      "issueId": "ENG-123"
    }
  }
}

Add an issue reaction

Use add_reaction_to_issue to add an emoji reaction to an issue.

Execution properties

Field	Type	Description
issueId	string	Required. UUID or identifier of the issue.
emoji	string	Required. Emoji shortcode, such as +1, thumbsup, or eyes.

Example

Add an emoji reaction to an issue:

Node configuration (click to expand)

{
  "identifier": "react-to-linear-issue",
  "title": "React to Linear issue",
  "config": {
    "type": "INTEGRATION_ACTION",
    "installationId": "linear-installation",
    "integrationProvider": "linear",
    "integrationInvocationType": "add_reaction_to_issue",
    "integrationActionExecutionProperties": {
      "issueId": "ENG-123",
      "emoji": "eyes"
    }
  }
}

Archive an issue

Use archive_issue to archive an issue.

Execution properties

Field	Type	Description
issueId	string	Required. UUID or identifier of the issue.

Example

Archive an issue:

Node configuration (click to expand)

{
  "identifier": "archive-linear-issue",
  "title": "Archive Linear issue",
  "config": {
    "type": "INTEGRATION_ACTION",
    "installationId": "linear-installation",
    "integrationProvider": "linear",
    "integrationInvocationType": "archive_issue",
    "integrationActionExecutionProperties": {
      "issueId": "ENG-123"
    }
  }
}

Delete an issue

Use delete_issue to move an issue to Linear's trash.

Execution properties

Field	Type	Description
issueId	string	Required. UUID or identifier of the issue.

Example

Delete an issue:

Node configuration (click to expand)

{
  "identifier": "delete-linear-issue",
  "title": "Delete Linear issue",
  "config": {
    "type": "INTEGRATION_ACTION",
    "installationId": "linear-installation",
    "integrationProvider": "linear",
    "integrationInvocationType": "delete_issue",
    "integrationActionExecutionProperties": {
      "issueId": "ENG-123"
    }
  }
}

Delegate an issue to an agent

Use delegate_issue_to_agent to delegate an issue to a Linear agent app user.

Execution properties

Field	Type	Description
issueId	string	Required. UUID or identifier of the issue.
delegateId	string	Required. UUID of the agent app user.

Example

Delegate an issue to a Linear agent app user:

Node configuration (click to expand)

{
  "identifier": "delegate-linear-issue",
  "title": "Delegate Linear issue",
  "config": {
    "type": "INTEGRATION_ACTION",
    "installationId": "linear-installation",
    "integrationProvider": "linear",
    "integrationInvocationType": "delegate_issue_to_agent",
    "integrationActionExecutionProperties": {
      "issueId": "ENG-123",
      "delegateId": "8df2102a-5f4a-4474-a8bc-7f0976e1534c"
    }
  }
}