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

# Linear

> Connect Linear to Omni for unified search across issues, projects, and documents

The Linear connector enables Omni to index and search content from your Linear workspace, including issues, projects, and documents.

## Overview

### What Gets Indexed

| Source    | Content                                                                    |
| --------- | -------------------------------------------------------------------------- |
| Issues    | Issue title, description, status, priority, assignee, labels, and comments |
| Projects  | Project name, description, and project updates                             |
| Documents | Document title and content                                                 |

### How It Works

1. You create a Linear API key with read access
2. The connector syncs issues, projects, and documents from your workspace
3. Optionally filter by specific teams using team keys
4. Team-based permissions ensure users only see content from teams they belong to

<Note>
  The connector uses read-only access. Omni cannot create, modify, or delete any content in your Linear workspace.
</Note>

## Prerequisites

Before setting up the Linear connector, ensure you have:

* **Linear account** with permission to create API keys
* **Omni deployment** with the Linear connector service running

## Setup

### Step 1: Create a Linear API Key

1. Go to [Linear Settings](https://linear.app/settings/api)
2. Click **Create key** under Personal API keys
3. Give the key a label (e.g., "Omni Search")
4. Copy the generated API key

<Warning>
  Keep your API key secure. Anyone with access to this key can read content from your Linear workspace.
</Warning>

### Step 2: Connect in Omni

1. Navigate to **Settings** → **Integrations** in Omni
2. Find **Linear** and click **Connect**
3. Enter your API key
4. Optionally enter team keys to limit syncing to specific teams (comma-separated)
5. Click **Connect**
6. Click **Sync Now** to start the initial sync

<Check>
  Your Linear connector is now configured. Initial indexing may take a while depending on the amount of content in your workspace.
</Check>

## Managing the Integration

### Viewing Sync Status

Navigate to **Settings** → **Integrations** to view the sync status for each source directly on the list, including last sync time, number of indexed items, and any errors. Click **Configure** on a source for more details.

### Sync Modes

The Linear connector supports two sync modes:

| Mode            | Description                                                       |
| --------------- | ----------------------------------------------------------------- |
| **Full**        | Syncs all issues, projects, and documents (used for initial sync) |
| **Incremental** | Syncs only items modified since last sync (used for updates)      |

After the initial full sync, the connector automatically performs incremental syncs to capture new and updated content.

### Team Filtering

To limit syncing to specific teams, provide team keys during setup. Team keys are the short identifiers visible in your Linear URLs (e.g., the "ENG" in ENG-123).

### Removing the Integration

1. Navigate to **Settings** → **Integrations**
2. Click **Configure** against the Linear source
3. Click **Delete Permanently**
4. Optionally, revoke the API key from your Linear settings

## Troubleshooting

<AccordionGroup>
  <Accordion title="Issues not appearing in search">
    Common causes:

    * Team filtering is excluding the relevant team
    * Sync has not completed yet
    * Team permissions don't allow the user to see results

    **Solution**: Check your team filtering configuration and verify that the sync has completed successfully.
  </Accordion>

  <Accordion title="API key validation failed">
    The token may be expired or revoked.

    **Solution**:

    1. Go to [Linear Settings](https://linear.app/settings/api)
    2. Regenerate your API key
    3. Update the key in Omni via **Settings** → **Integrations** → **Linear**
    4. Restart the Linear connector service
  </Accordion>

  <Accordion title="Rate limiting errors">
    Linear has API rate limits. The connector handles these automatically with backoff.

    **Solution**: Wait for the connector to retry. For large workspaces, initial sync may take longer due to rate limits.
  </Accordion>
</AccordionGroup>

## Security Considerations

* **Read-only access**: The API key only has read permissions
* **Team-based permissions**: Users only see content from teams they belong to in Linear
* **Token security**: API keys should be treated like passwords
* **Encrypted storage**: Credentials are encrypted at rest in Omni

## What's Next

<CardGroup cols={3}>
  <Card title="Search Your Data" icon="magnifying-glass" href="/user-guide/search">
    Learn how to search across Linear issues and documents
  </Card>

  <Card title="AI Assistant" icon="robot" href="/user-guide/ai-assistant">
    Ask questions about your Linear projects and issues
  </Card>

  <Card title="Add More Connectors" icon="plug" href="/connectors/overview">
    Connect additional data sources
  </Card>
</CardGroup>