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

# Linear

> Read and file issues in Linear during investigations.

Connect Linear so Foggy can surface related issues during an investigation and — with a full-access key — file a ticket from the findings.

## What Foggy can do

| Tool         | Description                                            |
| ------------ | ------------------------------------------------------ |
| **Issues**   | Search, read, and (with full-access key) create issues |
| **Projects** | Read project metadata                                  |
| **Cycles**   | Read active and recent cycles                          |
| **Teams**    | Read teams and members                                 |
| **Comments** | Read issue comments                                    |

## Setup

Go to **Connectors** → **Add Connector** → **Linear** and fill in the form.

| Field       | Required | Description                                                                                                                                    |
| ----------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**    | Yes      | Label for this connector (e.g. "Linear-Workspace")                                                                                             |
| **API Key** | Yes      | Linear → **Settings** → **Account** → **Security & Access**. A **Restricted** key is read-only. A **full-access** key lets Foggy file tickets. |

<Info>
  **Pick the narrowest key that works.** If you only want Foggy to reference existing issues in its answers, use a restricted read-only key. Upgrade to full-access only when you want Foggy to file tickets from investigation findings.
</Info>

## Troubleshooting

* **"Permission denied" on issue create** — the key is a restricted key. Re-issue as a full-access key, or keep the restricted key if you don't want Foggy to file tickets.
* **Empty team or project list** — Linear scopes are workspace-wide, but the key may have been created in a different workspace than expected. Regenerate from the workspace you want Foggy to see.

## Next steps

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="/integrations/github">
    Pair Linear with GitHub to link issues, PRs, and commits.
  </Card>

  <Card title="Slack" icon="slack" href="/integrations/slack">
    Get investigation results where your team already talks.
  </Card>
</CardGroup>