TestOps logo
Try TestOps

Linear

This integration is available starting with Allure TestOps version 26.3.1.0

The Linear integration lets Allure TestOps link issues to test artifacts inside the Linear workspace your team uses. It covers:

  • linking Linear issues to test cases, launches, defects, and mutes;
  • using Linear issue search from Allure TestOps inside the configured workspace boundary to link issues to Allure TestOps entities;
  • providing launch execution status to a linked issue;
  • creating Linear issues from Allure TestOps defects.

1. Create the Linear API key

  1. In Linear, click your team name in the upper-left corner and select Settings.
  2. Under Personal section click Security & access.
  3. Under Personal API keys, click New API key.
    1. Select the required permissions for the key.
    2. Select the team access for the key.
  4. Copy the generated API key. Save it for the next steps.

2. Add the global Linear integration

An instance administrator should:

  1. Open Administration → Integrations in Allure TestOps.

  2. Click + Add integration.

  3. Select Linear.

  4. Fill in the fields:

    • Name: a stable name for the integration, for example Linear.app;
    • Endpoint: the base URL of Linear, https://linear.app;
    • Endpoint for GraphQL API calls: https://api.linear.app for Linear Cloud, or the proxy endpoint approved by your organization. Do not add /graphql to the address, Allure TestOps adds it when it calls the Linear GraphQL API.

  5. Click Add integration.

3. Enable Linear in an Allure TestOps project

  1. Go to Administration → Integrations.
  2. Find and open your Linear integration.
  3. Go to the Projects tab.
  4. Click + next to the search field.
  5. Select the target Allure TestOps project.
  6. In the Personal API key field, paste the API key from step 1.
  7. Click Test connection. If the credentials are correct, a "Connection established" message appears.
  8. Click Add integration.

In an Allure TestOps project:

  1. Go to Settings → Integrations.
  2. Under Available integrations, find the Linear integration and click Add integration.
  3. In the Personal API key field, paste the API key from step 1.
  4. Click Test connection. If the credentials are correct, a "Connection established" message appears.
  5. Save the project integration.

Verify the integration

Check both the link flow and the defect flow:

  1. Open a test case in Allure TestOps and add an issue link.
    1. Confirm that the Linear picker finds Linear issues by issue ID or by a part of the issue name.
  2. Open a launch in Allure TestOps, click Edit, and add an issue link.
    1. Confirm that the Linear picker finds Linear issues by issue ID or by a part of the issue name.
  3. Open a defect in Allure TestOps and confirm that the Linear integration can create a new Linear issue or link the defect to an existing one.
© Qameta Software Inc. All rights reserved.