# Linear

The Linear integration connects Interlynk to your Linear workspace for vulnerability ticket creation and tracking.

***

## Purpose

* Create Linear issues for vulnerabilities discovered in SBOMs.
* Track remediation progress from within your existing Linear workflow.

## Setup Steps

1. Navigate to **Settings > Organization > Integrations**.
2. Click **Linear**.
3. Enter the following:
   * **Linear Host URL**: Pre-filled with the Linear API URL (not editable).
   * **API Token**: A Linear personal API key. Generate one from **Linear > Settings > API > Personal API keys**.
4. Click **Verify** to test the connection.
5. On success, the verification panel displays: account name, email, and account ID.
6. Click **Save**.

## Configuration

After connecting Linear, configure per-product settings in **Settings > Organization > Ticketing**:

* **Provider**: Select Linear.
* **Project Key**: Map to a Linear project.
* **Issue Type**: Select the issue type for vulnerability tickets.

## Required Permissions

### Linear API Key Permissions

The API key should have access to:

| Scope         | Purpose                             |
| ------------- | ----------------------------------- |
| Read projects | List available projects for mapping |
| Create issues | Create vulnerability tickets        |
| Read issues   | Track ticket status                 |

### Interlynk Permissions

| Permission           | Purpose                          |
| -------------------- | -------------------------------- |
| `view_connections`   | View Linear integration settings |
| `edit_connections`   | Configure Linear connection      |
| `delete_connections` | Remove the Linear integration    |

## Security Notes

* The Linear API token is encrypted at rest.
* Use a **service account** API key if available, rather than a personal key tied to an individual.
* Rotate the API key periodically and update the integration configuration.

## Troubleshooting

| Issue               | Cause                                      | Resolution                                  |
| ------------------- | ------------------------------------------ | ------------------------------------------- |
| Verification fails  | Invalid API token                          | Generate a new API key from Linear settings |
| Cannot see projects | Token lacks project read access            | Verify the API key has the correct scopes   |
| Tickets not created | Product not configured with Linear project | Set the project key in ticketing settings   |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.interlynk.io/administration/linear.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.