Linear

Overview

The Linear integration lets you create Linear issues and link existing ones directly from risks and incidents in Adversarial. A single risk or incident can have one or multiple linked issues.

The integration connects to Linear using an API Key scoped to your organization’s Linear account. You configure which Linear team issues are filed into, and the integration creates, searches, and links issues against that team.

Setup

Enable the integration from your Adversarial tenant via Settings > Integrations. You will need:

API Key — a Linear API Key from your organization’s Linear account. In Linear, go to Settings > My Account > API and create a new key. Copy it immediately — Linear only shows it once.
Team Key — the short identifier for the Linear team you want to file issues into (for example, ENG or SEC). You can find the team key in Linear under Settings > Workspace > Teams, or read it from the prefix of any existing issue in that team (e.g., ENG-123).

Enter both values in the integration configuration page and save. Adversarial resolves the team key to a stable internal identifier at save time, so issues continue to file correctly even if the team key is renamed in Linear later.

Creating a New Issue

In the Tickets section of a risk or incident record, select Linear and then + Create Issue.

The issue is pre-populated with the Title and Description from the record. You can edit either field before submitting. The issue is filed into the team you configured and opens immediately in Linear once created.

Linking an Existing Issue

In the Tickets section, select Linear and search for an existing issue by title or identifier (for example, ENG-123). Select the result to link it to the record.

Unlinking

Remove a link from the same Tickets section. Unlinking removes the association in Adversarial; it does not delete or modify the issue in Linear.