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

SourceContent
IssuesIssue title, description, status, priority, assignee, labels, and comments
ProjectsProject name, description, and project updates
DocumentsDocument 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
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 syncing to specific teams (comma-separated)
  5. Click Connect
  6. Click Sync Now 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 Configure on a source for more details.

​
Sync Modes

The Linear connector supports two sync modes:
ModeDescription
FullSyncs all issues, projects, and documents (used for initial sync)
IncrementalSyncs 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

The token may be expired or revoked.Solution:
  1. Go to Linear Settings
  2. Regenerate your API key
  3. Update the key in Omni via Settings → Integrations → Linear
  4. Restart the Linear connector service
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-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

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