Linear keeps disconnecting
Linear shows as disconnected on Settings → Integrations even though you reconnect it. Here is what was going on, and what to check on the current build.
Symptom: You connect Linear in Settings → Integrations. Within hours or days, the card flips back to "disconnected". You reconnect. It happens again. Frustrating.
Some history, then a checklist.
What was actually happening
Earlier this year, an OAuth-related webhook from Linear was being interpreted by Ochre as a revoke signal, even when the user had not actually disconnected. The result: Linear would silently flip to "disconnected" shortly after each reconnect. The user did nothing wrong.
That bug was fixed in May 2026. On the current Ochre build, this should not recur. If you are seeing the symptom today, the cause is something else and the checklist below will find it.
Checklist
1. Confirm you are on the current build
If your workspace is unusually old or has been paused, you may be running on a snapshot from before the May 2026 fix. Open any page in Ochre and look at the footer or the What's new indicator. If you cannot tell, contact support and we will check for you.
2. Reconnect once, cleanly
Go to Settings → Integrations, find the Linear card, and click Disconnect. Then click Reconnect. During the OAuth flow:
- Sign in to Linear as a user who has admin or workspace-level scopes, not a guest.
- Grant all requested scopes. Some teams have a habit of declining "read teams" thinking it is unnecessary. We need it.
- Land back on the Ochre card and confirm it shows green.
For the canonical setup see Linear integration.
3. Check who else is connected
Linear allows multiple OAuth grants per workspace, but some org admins enforce single-grant-per-app. If a teammate reconnects under their account, the previous grant can be invalidated. Decide on one connection owner, ideally a long-tenured admin.
4. Check Linear-side admin actions
Linear admins can revoke third-party app grants in bulk. If your security team ran an audit recently, the Ochre grant may have been revoked along with stale apps. Check Linear's Settings → API or Settings → Integrations page for the Ochre app.
5. Check user offboarding
If the person who originally connected Linear left your company, deactivating them in Linear can also kill the OAuth grant they owned. Reconnect under a current employee, ideally a service account. See integration permissions.
6. Confirm the symptom is real
Sometimes the card looks "disconnected" because the page is stale. Hard refresh (Cmd-Shift-R or Ctrl-Shift-R). If the card now shows green, you were chasing a ghost.
7. Verify it is not the historical bug
If, after reconnecting, the card flips back to "disconnected" within minutes with no Linear-side activity (no admin revoke, no offboarding, no other team member reconnecting), that pattern matches the historical bug. On the current build it should not happen. If it does, contact support immediately so we can inspect.
What "current build" means in practice
Ochre runs continuously deployed. Most workspaces see fixes within hours of release. There is no version pin. If your workspace is paused, on legal hold, or otherwise frozen, that is the only way to be on an older build, and support can confirm your status in seconds.
When to contact support
Contact us if:
- You have reconnected cleanly under an admin, the Linear-side grant looks healthy, no admin revoke happened, and the card still flips to "disconnected" within hours.
- You see two Linear cards in Settings → Integrations at the same time.
- The Linear card shows "disconnected" but Linear data is still flowing into Ochre, or vice versa.
Send the Linear workspace name, the Ochre user who owns the OAuth grant, and the timestamps of the last two flip events in UTC. See support contact.
Related reading
Was this article helpful?