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

​
Overview

​
What Gets Indexed

​
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
The connector uses read-only access. Omni cannot create, modify, or delete any content in your Linear workspace.

​
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
  2. Click Create key under Personal API keys
  3. Give the key a label (e.g., “Omni Search”)
  4. Copy the generated API key
Keep your API key secure. Anyone with access to this key can read content from your Linear workspace.

​
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
Your Linear connector is now configured. Initial indexing may take a while depending on the amount of content in your workspace.

​
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: 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

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.
The token may be expired or revoked.Solution:
  1. Go to Linear Settings
  2. Regenerate your API key
  3. Delete the existing Linear source in Omni and reconnect it with the new key
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.

​
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

Search Your Data

Learn how to search across Linear issues and documents

AI Assistant

Ask questions about your Linear projects and issues

Add More Connectors

Connect additional data sources