Linear
The Linear panel — how to read the integration health, manage OAuth installations, and respond to degraded states.
The Linear panel (/home/linear) is the operational view for your Linear OAuth integration. It shows you whether the connection is healthy, which workspaces are installed, and what scopes have been granted. The actual setup steps — creating the OAuth app and pasting credentials — are on the Linear Setup page, linked from here.
Integration status
The hero section at the top of the panel shows a large status indicator with one of four states:
| State | Meaning |
|---|---|
| Installed | The OAuth app is installed and webhooks are flowing normally. |
| Needs attention | The installation is degraded — a token refresh has failed or reauthorisation is required. |
| Ready to install | Credentials have been saved but the app has not been installed into a Linear workspace yet. |
| Connect Linear | No credentials have been saved yet. Setup has not been started. |
The status updates automatically when you navigate to the panel. If something is wrong, the panel surfaces a contextual description of what needs to be fixed and links to the relevant action.
Overview cards
Three cards beneath the hero give a quick summary:
Status card — mirrors the hero state with a short description and a link to the setup page.
Workspaces card — lists the Linear workspaces the app has been installed into. Each entry shows the organisation name and the OAuth scopes that were granted. If no workspace is installed yet, the card shows a prompt to install.
Credentials card — confirms whether a client ID has been saved. The client ID is shown truncated in monospace. Secrets (client secret, webhook signing secret) are never displayed after saving — the card confirms they are stored encrypted at rest.
Installations list
Below the overview cards is the full list of installations. Each row shows:
- The organisation name (or the Linear workspace URL key if the name is unavailable).
- The scopes granted to the app, in monospace separated by
·. - A status pill with one of four states:
- Installed — healthy.
- Revoked — the app was uninstalled from Linear or its access was revoked.
- Reauthorisation required — Linear has flagged the installation as needing a fresh OAuth consent.
- Token refresh failed — the relay attempted to refresh the access token automatically and failed.
Non-revoked installations have a Disconnect button that marks the installation as revoked on the Delego side. This stops webhook processing for that workspace without affecting the OAuth app itself in Linear.
Responding to degraded states
If the status shows Needs attention, the most common causes are:
- Token refresh failed — the Linear access token expired and the automatic refresh failed, usually because the client secret was rotated in Linear. Go to Manage setup, update the client secret, and reinstall.
- Reauthorisation required — Linear requires the user to go through the OAuth consent flow again. Click Install on the setup page to re-authorise.
After fixing the underlying issue, navigate back to the Linear panel to confirm the status returns to Installed.