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

# Linear

> Create Linear issues from Tierity findings and view your team's issue backlog.

## Overview

The Linear integration lets you create issues directly from security findings, coverage gaps, and other Tierity data — and view your team's Linear backlog without leaving the platform.

## How authentication works

The Linear integration uses a **two-tier model**:

| Tier | Used for | Where it's configured |
| - | - | - |
| **Org API key** | Reading issues, creating issues on behalf of the platform | Config → Integrations → Linear |
| **Personal API key** | Write actions attributed to you (comments, status transitions) | Profile → Connections |

The org key handles data sync and org-initiated issue creation. When you take an action from your own account (such as moving an issue or adding a comment), Tierity uses your personal API key so the action appears under your identity in Linear. If no personal key is configured, write actions fall back to the org key.

## Prerequisites

* A Linear workspace
* Manage access (or higher) in Tierity (for org setup)

## Setup

**1. Create an org API key**

1. In Linear, go to **Settings → API → Personal API keys** (or use a service account).
2. Click **Create key**, give it a name like "Tierity Org", and copy the key.

**2. Configure the org connection**

1. Go to **Config → Integrations → Linear**.
2. Enter the **API Key**.
3. Select the default **team** and **project** for new issues.
4. Click **Save & Test**.

**3. Add your personal API key (optional)**

1. In Linear, go to **Settings → API → Personal API keys** and create a key for yourself.
2. In Tierity, go to **Profile → Connections** and configure **Linear**.
3. Paste your personal key — Tierity will use it for write actions attributed to you.

## Creating issues

From any finding or risk in Tierity, use the **Create Linear Issue** action to push it to Linear with the title, description, and severity pre-filled. You can adjust the team, project, priority, and assignee before submitting.

## What's available

| Feature | Description |
| - | - |
| **Issue creation** | Push findings to Linear with one click |
| **Issue view** | Browse open and in-progress issues assigned to your team |
| **Backlog** | View the full backlog filtered by project or cycle |
| **Write actions** | Move issues, add comments, update status using your personal key |


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