Integrating with Linear
Overview
Integrating with Linear enables you to:
- Create Linear issues for entire Actions or any number of individual findings directly from the Actions page.
- Create Linear issues for single or multiple security findings directly from the Backlog page.
Steps for integrating with Linear
-
Generate an API token from your Linear account.
-
From the Jit platform, select Secrets in the menu bar under Settings.
-
Follow the instructions in Secrets to store this API token as a secret.
-
Select Integrations.
-
Locate the Linear tile and select Integrate as-code. You are taken to the
jit-integration.yml
file. Add your API token and relevant Linear data to this file. If the option to integrate as-code is not available, you may need to manually addjit-integration.yml
to the repo containing Jit's configuration files.linear: Engineering: auth: api_token: ${{ jit_secrets.linear-token }} preferences: team_id: your-team-id Project_id: optional
Key | Value/description |
---|---|
linear: | Integration type. Key must be linear . The Linear integration is nested in this mapping. The jit-integration.yml file does not support concurrent integration of different ticket management systems. |
Engineering: | This key is the name you choose for your Linear integration. Engineering is used in the above example. |
api_token: | See procedure steps. |
team_id: | Retrieve this value by querying the graphql API at https://api.linear.app/graphql. For instructions, see Linear documentation. |
Project_id: | Retrieve this value by querying the graphql API at https://api.linear.app/graphql. For instructions, see Linear documentation. |
Updated 29 days ago