> ## 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 and description, plus separately indexed 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 issue fetching by specific teams using team keys
4. Linear permission metadata is preserved where available; projects and documents without retained team keys are indexed as public

<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 issue syncing to specific teams (comma-separated)
5. Click **Connect**
6. Click **Sync** 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 **Settings** on a source for more details and sync history.

### 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 issue 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). Projects and documents are fetched workspace-wide; items without a retained team key are indexed as public.

### Removing the Integration

1. Navigate to **Settings** → **Integrations**
2. Click **Settings** 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
    * The item was not returned by the connector's issue filter

    **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. Delete the existing Linear source in Omni and reconnect it with the new key
  </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 filtering**: Team keys limit issue fetching; they do not limit workspace-wide project and document fetching
* **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>