Linear
Modern issue tracking.
Access mode: Read-only
Required information
| Field | Details |
|---|---|
| Workspace | Linear workspace. |
| Authentication | OAuth 2.0 app or API key. |
| Scope | Read-only: read scope. |
| Teams | Specific teams or all teams in workspace. |
Network considerations
Fully managed SaaS. HTTPS to api.linear.app. No VPN needed.
Credential and auth management
Preferred: OAuth 2.0 app. Registered in Linear Settings → API → OAuth Applications. Scoped to read.
Acceptable: Personal API key. Workspace-wide, tied to a user. Use a dedicated service account.
Rate limit: 1,500 requests/hour for API key, 3,000/hour for OAuth.
Validation checks
| Check | Method | Expected result |
|---|---|---|
| Authentication | GraphQL query: { viewer { id name } } | Returns authenticated user |
| Team access | GraphQL: { teams { nodes { id name } } } | Lists teams |
| Issue read | GraphQL: { issues(first: 1) { nodes { title state { name } } } } | Returns an issue |
Every connection starts from the pre-engagement checklist and goes through the universal validation protocol before production sign-off.