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

# Linear

> Learn how to connect your Opal instance with Linear.

Opal's integration with Linear allows you to manage access to Linear organizations, projects and teams.

## Supported resources

| Resource            | Read | Manage access levels | Grant and revoke access | Available in Risk Center |
| ------------------- | ---- | -------------------- | ----------------------- | ------------------------ |
| Linear teams        | ✔️   |                      | ✔️                      | ✔️                       |
| Linear projects     | ✔️   |                      | ✔️                      | ✔️                       |
| Linear organization | ✔️   | ✔️                   |                         | ✔️                       |

## Requirements

Before you begin, you must:

* Be an Opal Admin
* Be on version `1.1215.0`, if you self-host Opal

## 1. Create a Linear admin personal API key

To allow Opal to access and manage your Linear organization, teams and projects, you must first create a [Personal API key](https://linear.app/docs/api-and-webhooks#api-keys). You will only be shown the API key on creation, so save it for the next steps.

In **Settings > Security & Access** under **Personal API keys** select the **New API key** option. Select the following permissions:

* `Read`
* `Write`
* `Admin`

## 2. Create Linear app in Opal

In Opal, go to **Inventory** > **+App** and select **Linear**. Name your Linear app, provide a description, and enter the personal API key you generated in step 1.

After you save the app, you can import organizations, projects and teams from **...** > **Import items**.

## Organization management

Once a user is synced from Linear into Opal, admins can manage the user's access level (admin, member or guest). Opal does not support user provisioning for Linear, so users cannot be added or removed from the Linear organization through Opal.