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

# Linear

> Use a Linear API key and team ID (team-level) to let Nota read or create Linear issues.

# ➿ Linear (team feature)

Linear connects at the team level. Generate a Linear API key and provide the team ID the agent should target. Use the Linear card on the Integrations page—**Configure** on first use, **Update** to change it later. Saved credentials apply to the whole workspace.

<img src="https://mintcdn.com/notaai/1x5ZOEq8LGaWrXEp/images/integrations-linear.png?fit=max&auto=format&n=1x5ZOEq8LGaWrXEp&q=85&s=5291657f2611b9f0e9ce36b4ad135909" alt="Placeholder: Linear API key settings" width="1" height="1" data-path="images/integrations-linear.png" />

## What you need

* **Linear API Key**
* **Linear Team ID** for the team you want Nota to use
* Admin access to **Integrations → Linear** in the left nav

## Create a Linear API key

1. Open Linear and click your avatar → **Settings**.
2. Under **Account**, select **API**.
3. Click **Create new personal API key**, name it (e.g., “Nota”), and copy the value shown once.
4. Keep the key private; treat it like a password.

## Find your Linear team ID

Option 1 — from the URL:

1. Open your team in Linear: `https://linear.app/<workspace>/team/<team-key>/...`.
2. The `team-key` portion uniquely identifies the team (e.g., `pl` for Platform). Use this as the team ID.

Option 2 — via GraphQL (precise):

```bash theme={null}
curl https://api.linear.app/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: <YOUR_LINEAR_API_KEY>" \
  -d '{ "query": "{ teams { id name key } }" }'
```

Use the `id` value that matches your team `name/key`.

## Add credentials to Nota

1. Open **Integrations** in the left nav and select the **Linear** card.
2. Paste your **Linear API Key**.
3. Enter the **Linear Team ID** (team key or `id` from the GraphQL query).
4. Save. The key is stored for the team—no environment variable or redeploy required.