Linear Integration
Mirror your Linear issues into Sophic, where they become searchable documents alongside the rest of your team's knowledge.
Connect
- In Linear, open Settings → Account → API → Personal API keys and create a key.
- In Sophic, open Settings → Integrations → Linear.
- Paste the key into Linear API key and click Connect.
Sophic validates the key against Linear's GraphQL API immediately and shows your organization name and the last four characters of the key for confirmation. Connecting requires an admin or owner role.
What gets synced
Each Linear issue becomes a Sophic document, including:
- Issue identifier, title, and description
- State, priority, assignee, team, project, and labels
- All comments on the issue
The sync is one-way — edits in Sophic don't write back to Linear.
Sync cadence
- Initial backfill runs as soon as you connect.
- A scheduled sweep runs about every 15 minutes to pull new and updated issues.
- A Sync now button triggers an immediate pull.
Syncs are workspace-locked so two runs never overlap.
Configuration (operators)
Self-hosted deployments need one environment variable so the scheduled sweep can authenticate:
| Variable | Purpose |
|---|---|
LINEAR_CRON_SECRET | Bearer secret protecting POST /api/linear/sync-all |
Pasted API keys are encrypted at rest (pgsodium).
Next steps
- Google Drive — sync documents and files
- API Reference — query synced issues programmatically