Skip to main content

Linear

The AISafe Linear integration lets you export findings as Linear issues from the AISafe dashboard, keeping your engineering team's workflow in their preferred issue tracker.

How it works​

Connecting Linear to your AISafe organization gives AISafe the ability to create issues in your Linear workspace. From any assessment's findings page, you can click Create issue to export a finding as a Linear issue. The issue includes the finding title, description, severity, evidence, and a link back to the finding in AISafe.

Connecting Linear​

  1. Navigate to Integrations in the AISafe dashboard.
  2. Click Connect Linear and authorize AISafe in your Linear workspace.
  3. Add an exporter in assessment or project Settings, selecting the Linear team.
  4. Add more destinations as needed.

Exporting findings​

From a finding detail page or the findings list:

  1. Click Create issue (available to managers and above).
  2. Select a configured destination and review the full finding preview.
  3. If the full finding exceeds the destination limit, explicitly choose a summary with an authenticated evidence link.
  4. Click Create issue. Each destination keeps its own ticket history.

AISafe records each export attempt on the finding, tracking the issue URL and status. If an issue exists for a finding, AISafe shows the existing issue link rather than creating a duplicate. For recurring findings with the same non-empty root-cause fingerprint, AISafe also reuses an existing Linear issue for the same export target across scans.

Each export sends Linear an issue ID that AISafe chooses, and every retry of that export sends the same ID. If Linear's response is lost, AISafe looks the ID up and links the issue if Linear created it. If Linear has no such issue yet, you can retry safely: Linear refuses a second issue with the same ID, so a retry never creates a duplicate. See When an export fails.

Ticket synchronization checks the team's permanent identity. Teams with the same name or key in different workspaces remain separate. If AISafe cannot verify which team owns a ticket event, it leaves the finding's ticket history unchanged. If a workflow offers no permitted status change, the destination picker explains the refusal beside the existing ticket link. It does not create a replacement ticket.