Connect Linear to Elido

The Linear integration opens an issue automatically when Elido detects a broken link: a short link whose destination returns an error or stops responding. The broken-link monitor checks links once a day.

What you need

• A Linear account with permission to create issues in the target team.
• A Linear personal API key (takes 30 seconds to generate).
• An Elido role that can manage integrations in the workspace.

Generate a Linear API key

1. Go to Linear → Settings → API → Personal API keys.
2. Click Create key. Give it a label like "Elido integration".
3. Copy the key. Linear only shows it once.

Configure in Elido

1. Go to Dashboard → Integrations → Linear.
2. Paste the API key and validate it. Elido lists every team your key has access to.
3. Select the target team. Issues will be created there.
4. Save. The key is stored encrypted.

What gets written to Linear

When a link is first detected as broken (and again if it is still broken 24 hours later), Elido opens one issue titled "Broken link: [short URL]". It contains:

• The short URL and destination URL.
• The HTTP status code and error message, when available.
• The time Elido detected the problem.

Elido creates only one issue per detection and does not read back from Linear — it won't close issues or track issue state. That part is up to your team's workflow.

Troubleshooting

"Not authorized" when validating the key — The API key is wrong or has been revoked. Re-generate from Linear Settings → API.

Issues appearing in the wrong team — Verify the team selection in Dashboard → Integrations → Linear. If a key has access to multiple teams, the picker might have defaulted to the first one.

No issue created — Only broken links create issues. Check that the Linear connection shows as connected and has not been revoked.

Duplicate issues — Elido opens at most one issue per detection. If you see duplicates, check that the same Linear team isn't connected under two Elido workspaces.