Skip to main content
The Linear connector indexes issues, comments, and related content from your Linear workspace.

​
What gets indexed

  • Issues
  • Comments
  • Labels
  • Projects
  • Teams (public only)
  • Issue metadata
Only issues from public teams are indexed. Private teams are excluded to respect team privacy settings.

​
Setup

1

Connect to Grapevine

  1. In Grapevine, go to Integrations and click on Linear
  2. Click the link to open Linear Settings → Security & Access
  3. Create a new API key with Read permissions
  4. Copy the API key (starts with lin_api_)
2

Enter API key

  1. Return to the Grapevine integration page
  2. Paste your Linear API key
  3. Click Save
3

Configure webhook

  1. Click the link to open Linear Settings → API
  2. Create a new webhook with URL: https://[your-tenant].ingest.getgrapevine.ai/webhooks/linear
  3. Select events: Comments, Users, Issues, Projects
  4. Copy the signing secret
  5. Return to Grapevine and paste the signing secret
  6. Click Save
4

Indexing begins

Grapevine will automatically begin indexing your Linear issues and comments. The initial sync may take time depending on the number of issues in your workspace.

​
Permissions

The Linear connector respects Linear permissions:
  • Only public teams are indexed (private teams are excluded)
  • API key has access only to teams and issues visible to the key owner
  • Archived issues are not indexed by default

​
Sync behavior

The initial indexing process may take time depending on the number of issues in your workspace. Real-time updates are configured automatically via webhooks.
  • Initial sync - Begins automatically after setup completion
  • Ongoing syncs - Real-time updates via webhooks keep your index current
  • Deletions - Deleted issues are removed from the index automatically

​
Limitations

  • Only public teams are indexed (private teams are excluded)
  • Archived issues are not indexed by default
  • Attachments are not indexed (only metadata)