Linear integration

Back to list of integrations

Use the Linear integration to let agents create and update issues and projects, comment on issues, and run GraphQL queries through Action Tools.

Authentication	Actions	Workflow triggers
OAuth 2.0, API Key	6	3

​

Supported actions

Actions are Linear operations that an agent runs as Action Tools during a conversation. You can also run them from an Integration node in a workflow.

Action	Use it to
Create Issue	Create an issue in a team.
Update Issue	Update an issue.
Create Comment	Comment on an issue.
Create Project	Create a project.
Update Project	Update a project.
Raw GraphQL query	Run any Linear GraphQL query or mutation.

​

Workflow triggers

Triggers are Linear events that start a workflow automatically. Select them as app triggers when you configure a workflow.

Trigger	Fires when

​

Set up the integration

1. Get Linear credentials

   For API Key, create a personal API key in Linear under Settings > Security & access. For OAuth 2.0, create an OAuth application in Linear, add the Artemis Callback URL as a redirect URI, and copy the Client ID and Client Secret. See Linear API.

2. Create the auth profile

   In Integrations, select Linear > Connect. On Project Auth Profiles, select New Profile > Integration Profile > Linear > Continue. Select OAuth 2.0 or API Key, enter the credentials, and select Create Profile. For OAuth 2.0, select Authorize.

   Usage Mode: Preconfigured shares one authorization across users; JIT and Preflight ask each user to authorize, during or before the session. See Auth profiles.

3. Create the action tool

   In Tools, select New Tool > Action > Linear > Continue. Select the Action and Auth Profile, set parameter defaults (leave a value empty for the agent to supply at runtime), and select Create Tool. Then assign the tool to an agent.

​

Action reference

Create Issue

Parameter	Type	Description
team_id	enum	Team.
title	string	Title.
description	string	Description.
state_id	enum	Status.
labels	array	Labels.
assignee_id	enum	Assignee.
priority_id	enum	Priority.
template_id	enum	Issue template.

Update Issue

Parameter	Type	Description
team_id	enum	Team.
issue_id	enum	Issue to update.
title	string	Title.
description	string	Description.
state_id	enum	Status.
labels	array	Labels.
assignee_id	enum	Assignee.
priority_id	enum	Priority.

Create Comment

Parameter	Type	Description
team_id	enum	Team.
user_id	enum	Comment author.
issue_id	enum	Issue.
body	string	Comment content.

Create Project

Parameter	Type	Description
team_id	enum	Team.
name	string	Project name.
description	string	Description.
icon	string	Icon.
color	string	Color.
startDate	string	Start date.
targetDate	string	Target date.

Update Project

Parameter	Type	Description
team_id	enum	Team.
project_id	enum	Project to update.
name	string	Project name.
description	string	Description.
icon	string	Icon.
color	string	Color.
startDate	string	Start date.
targetDate	string	Target date.

Raw GraphQL query

Parameter	Type	Description
query	string	GraphQL query.
variables	object	Query variables.

​

Troubleshoot common issues

Issue	Resolution
Team, status, or assignee lists are empty	Confirm the authorized account is a member of the team.
Authentication required	Check the API key, or authorize the OAuth profile again.
GraphQL errors from Raw GraphQL query	Validate the query in the Linear API explorer.

Related articles:

• Auth profiles
• Action Tools
• Linear developer documentation