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

# Linear

> Connect Linear for issue tracking and project context during investigations.

Connecting Linear allows Traversal to access issues and projects, enabling correlation of incidents with engineering work.

## What Traversal reads

* **Issues** — title, description, status, priority, labels, and assignee
* **Comments** — full comment thread on each issue
* **Attachments** — images attached to issues and comments

## Setup

<Steps>
  <Step title="Create an API key">
    1. In Linear, go to **Settings → Security and Access → Personal API Keys**
    2. Click **New API Key**, give it a name (e.g. `traversal-prod`), and click **Create**
    3. Copy the generated API key (starts with `lin_api_`)
  </Step>

  <Step title="Configure in Traversal">
    Go to **Company Knowledge → Integrations**, select **Linear**, and paste the API key.

    Click **Save**.
  </Step>
</Steps>

## More information

* [Linear API keys](https://developers.linear.app/docs/graphql/working-with-the-graphql-api#personal-api-keys)