Linear

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 integration actions share the same node structure:

Field	Type	Description
type	string	Required. Must be "INTEGRATION_ACTION".
installationId	string	Required. Your Linear integration installation ID.
integrationProvider	string	Required. Must be "linear".
integrationInvocationType	enum	Required. One of the values listed in available actions.
integrationActionExecutionProperties	object	Required. Properties for the selected action.

The remaining sections describe the execution properties of each action.

Available actions

Each action is selected with the integrationInvocationType field:

Action	Invocation type	Description
Manage an issue	create_issue	Create an issue in a Linear team
Manage an issue	create_sub_issue	Create a child of an existing issue
Manage an issue	update_issue	Update an existing issue

| Add a comment | add_comment | Add Markdown content to an issue | | Add a document | add_document | Create a document associated with an issue or project | | Add an issue reaction | add_reaction_to_issue | Add an emoji reaction to an issue |

The remaining sections describe the execution properties of each action.

Issue actions

Manage an issue

Create or update an issue.

Create

Creates an issue in a Linear team. Set integrationInvocationType to create_issue.

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.

Basic example

Create an issue in a Linear team (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 sub-issue

Creates a child of an existing issue. Set integrationInvocationType to create_sub_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).

Basic example

Create a sub-issue under an existing parent issue (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

Updates an existing issue. Set integrationInvocationType to update_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.

Basic example

Update an existing issue (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"
    }
  }
}

Comment and document actions

Add a comment

Adds Markdown content to an issue. Set integrationInvocationType to add_comment.

Execution properties

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

Basic example

Post a comment on an issue (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

Creates a document associated with an issue or project. Set integrationInvocationType to add_document. 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.

Basic example

Create a document linked to an issue (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"
    }
  }
}

Reaction actions

Add an issue reaction

Adds an emoji reaction to an issue. Set integrationInvocationType to add_reaction_to_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.

Basic example

Add an emoji reaction to an issue (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"
    }
  }
}