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 a completed workflow state for the team that owns the ticket.

SubImage also adds a SubImage label when the integration can read or create labels. A label failure does not prevent ticket creation.

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

Choose a team and optional project

For ongoing security work, we recommend a dedicated Linear team, such as Security. A team gives you a persistent backlog with its own workflow, access settings, and cycles. Use the route's filters to limit which SubImage issues become tickets.

Select a project when you want new tickets to contribute to a specific effort, such as an audit or a quarterly hardening project. Linear recommends projects with a clear outcome or completion date, although it also supports projects for ongoing work.

Every ticket still belongs to the selected team, even when you choose a project. A project groups tickets; it does not remove them from the team's issue lists. Each Linear issue can belong to only one project.

If you want to keep security work in your existing team, you can also create a custom view filtered by the SubImage label.

Consent scope

When you install Linear, SubImage requests the write scope through Linear OAuth. Linear includes read access by default, so selecting a project needs no additional 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.

Set up Linear routing

1. Install Linear from Settings > Integrations. This requires an admin user, and the Linear integration must be enabled for your deployment.
2. Open Settings > Issue Routing and create or edit a route.
3. Set filters for the issues you want to send, then select Linear as the destination. Without filters, the route matches every issue.
4. Select the Team that should receive new tickets.
5. Optionally select a Project associated with that team. Leave it empty to create tickets without a project. Completed, canceled, and archived projects are not listed. Changing the team clears the project selection.
6. Save the route.

The selected team and project apply to new tickets. Changing the route does not move existing tickets, and SubImage preserves project changes you make in Linear.

SubImage maps each issue's priority score to Linear's priority: 80 and above becomes Urgent, 60 and above becomes High, 30 and above becomes Medium, and anything lower becomes Low.

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 a selected project is completed, canceled, archived, removed from the team, or no longer accessible, SubImage reports a delivery error instead of creating a ticket elsewhere. Select another project or clear Project, then retry the delivery. Existing linked tickets can still receive updates and close.

If SubImage cannot close a linked issue, confirm the team that owns the ticket has a workflow state in Linear's completed category.