Linear

Connect Linear from Settings > Integrations to let SubImage create and close remediation tickets in Linear.

What SubImage Does

SubImage creates a Linear issue from an issue route and stores the created issue link on the SubImage issue. When the SubImage issue changes, SubImage updates the linked Linear issue's title, description, and priority. When the SubImage issue closes because the underlying evidence is no longer active, SubImage posts a comment on the linked Linear issue and transitions it to the route's configured closed state.

SubImage does not read arbitrary Linear issues, manage issues it did not create and link, or receive webhooks from Linear.

Consent Scope

When you install Linear, SubImage requests the single Linear write scope. The OAuth flow runs through https://linear.app/oauth/authorize and returns to SubImage's hosted callback at https://app.subimage.io/api/integrations/linear/callback.

SubImage Setup

1. Install Linear from Settings > Integrations. This requires an admin user, and the Linear integration must be enabled for your deployment.
2. Find the Linear team ID that should receive remediation tickets.
3. Create or update an issue route with destination linear and that team ID.
4. Optionally set a priority and a closed state for the route.

If you do not set a priority on the route, SubImage maps it from the SubImage issue priority score: 80 and above becomes Urgent, 60 and above becomes High, 30 and above becomes Medium, and anything lower becomes Low.

If you do not set a closed state, SubImage still posts the closing comment but leaves the Linear issue in its current state.

Troubleshooting

If Linear rejects the stored token, reinstall the Linear integration so Linear issues a fresh grant.

If Linear cannot create the issue, confirm the route's team ID exists and the authorizing Linear user has access to that team.

If SubImage cannot close the linked issue, confirm the route's closed state matches an available Linear workflow state for that team.