
Linear Issues Create
CertifiedCreate an issue in Linear
Linear Issues Create
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.
type: io.kestra.plugin.linear.issues.CreateExamples
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.
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.
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 *string
Team name
Linear team name used to look up the team id; comparison is case-insensitive.
assets
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.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset 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.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150description string
Issue description
Optional issue body; rendered with flow variables before sending to Linear.
labels array
Label names
Labels to attach, matched by name. If empty, the issue is created without labels.
priority integerstring
Priority
Linear priority: 0 (none), 1 (urgent), 2 (high), 3 (medium) or 4 (low). Leave empty to use the Linear default.
title string
Issue title
Title text for the issue; templating supported through property rendering.
token string
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.
Outputs
isSuccess boolean
Shows whether request was successful
True when the API call returns HTTP 200 and Linear reports success for the mutation.
issueId string
Issue id
UUID of the created issue when the mutation succeeds.
issueIdentifier string
Issue identifier
Human-readable identifier of the created issue when the mutation succeeds, e.g. ENG-123.
issueUrl string
Issue URL
Web URL of the created issue when the mutation succeeds.