Linear Issues Create

Linear Issues Create

Certified

Create an issue in Linear

Creates a Linear issue via GraphQL. Resolves the team by name (case-insensitive) and optionally attaches labels by their names. Returns Linear's mutation success flag along with the created issue's id, human-readable identifier (e.g. ENG-123) and URL.

yaml
type: io.kestra.plugin.linear.issues.Create
yaml
id: linear_issues_create
namespace: company.team

tasks:
  - id: create_issue
    type: io.kestra.plugin.linear.issues.Create
    token: "{{ secret('LINEAR_API_TOKEN') }}"
    team: MyTeamName
    title: "Increased 5xx in Demo Service"
    description: "The number of 5xx has increased beyond the threshold for Demo service."
    labels:
      - Bug
      - Workflow

Create an issue when a Kestra workflow in any namespace with company as prefix fails.

yaml
id: create_ticket_on_failure
namespace: system

tasks:
  - id: create_issue
    type: io.kestra.plugin.linear.issues.Create
    token: "{{ secret('LINEAR_API_TOKEN') }}"
    team: MyTeamName
    title: Workflow failed
    description: "{{ execution.id }} has failed on {{ taskrun.startDate }}. See the link below for more details."
    labels:
      - Bug
      - Workflow

triggers:
  - id: on_failure
    type: io.kestra.plugin.core.trigger.Flow
    conditions:
      - type: io.kestra.plugin.core.condition.ExecutionStatus
        in:
          - FAILED
          - WARNING
      - type: io.kestra.plugin.core.condition.ExecutionNamespace
        namespace: company
        comparison: PREFIX

Create an issue and log its identifier and URL.

yaml
id: linear_issues_create_and_log
namespace: company.team

tasks:
  - id: create_issue
    type: io.kestra.plugin.linear.issues.Create
    token: "{{ secret('LINEAR_API_TOKEN') }}"
    team: MyTeamName
    title: "Increased 5xx in Demo Service"
    description: "The number of 5xx has increased beyond the threshold for Demo service."
    labels:
      - Bug
      - Workflow

  - id: log_issue
    type: io.kestra.plugin.core.log.Log
    message: "Created issue {{ outputs.create_issue.issueIdentifier }} at {{ outputs.create_issue.issueUrl }}"
Installation

Our standard Docker images already include this plugin. If you use a -slim image or another setup, install it with the following command:

kestractl plugins get io.kestra.plugin:plugin-linear --compatible-for $KESTRA_VERSION

For kestractl, use your Kestra version with --compatible-for, or specify an exact plugin version.

For Kestra CLI, replace LATEST with a specific version or version range to pin the plugin version.

Properties

Team name

Linear team name used to look up the team id; comparison is case-insensitive.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

Issue description

Optional issue body; rendered with flow variables before sending to Linear.

SubTypestring

Label names

Labels to attach, matched by name. If empty, the issue is created without labels.

Priority

Linear priority: 0 (none), 1 (urgent), 2 (high), 3 (medium) or 4 (low). Leave empty to use the Linear default.

Issue title

Title text for the issue; templating supported through property rendering.

Linear API token

Full Authorization header value for Linear (usually the personal API key). Treat as secret and supply any needed prefix such as Bearer yourself.

Shows whether request was successful

True when the API call returns HTTP 200 and Linear reports success for the mutation.

Issue id

UUID of the created issue when the mutation succeeds.

Issue identifier

Human-readable identifier of the created issue when the mutation succeeds, e.g. ENG-123.

Issue URL

Web URL of the created issue when the mutation succeeds.