> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear integration

[Back to list of integrations](https://koreai.mintlify.site/agent-platform/integrations/enterprise-systems.md)

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](#supported-actions) | [3](#workflow-triggers) |

## 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](https://koreai.mintlify.site/agent-platform/workflows.md#integration-node) in a workflow.

| Action | Use it to |
| - | - |
| [Create Issue](#create-issue) | Create an issue in a team. |
| [Update Issue](#update-issue) | Update an issue. |
| [Create Comment](#create-comment) | Comment on an issue. |
| [Create Project](#create-project) | Create a project. |
| [Update Project](#update-project) | Update a project. |
| [Raw GraphQL query](#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](https://koreai.mintlify.site/agent-platform/workflows.md#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](https://linear.app/developers).

**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](https://koreai.mintlify.site/agent-platform/administration/integrations-settings.md#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](https://koreai.mintlify.site/agent-platform/tools/actions.md#assign-an-action-to-an-agent).

## Action reference

> [accordion] 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. |

> [accordion] 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. |

> [accordion] Create Comment
>
> | Parameter | Type | Description |
> | - | - | - |
> | `team_id` | enum | Team. |
> | `user_id` | enum | Comment author. |
> | `issue_id` | enum | Issue. |
> | `body` | string | Comment content. |

> [accordion] 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. |

> [accordion] 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. |

> [accordion] 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](https://studio.apollographql.com/public/Linear-API/variant/current/home). |

**Related articles:**

* [Auth profiles](https://koreai.mintlify.site/agent-platform/administration/integrations-settings.md#auth-profiles)
* [Action Tools](https://koreai.mintlify.site/agent-platform/tools/actions.md)
* [Linear developer documentation](https://linear.app/developers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.