TestOps logo
Try TestOps

Linear

This integration is available starting with Allure TestOps version 26.3.1.0

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 defect Allure TestOps.

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 required permissions for the key.
    2. Select 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:
      • cloud: https://linear.app;
    • Endpoint for GraphQL API calls — the Linear GraphQL API Endpoint:

  5. Click Add integration.

4. 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 TestOps project.
  6. Under Lists, click + Add and enter the list ID from step 2. Repeat for each list the project should search.
  7. In the Personal API Token field, paste the token from step 1.
  8. Click Test connection. If the credentials are correct, a "Connection established" message appears.
  9. 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. Under Lists, click + Add and enter the list ID from step 2. Repeat for each list the project should search.
  4. In the Team ID field, enter the team ID from step 2.
  5. In the Personal API Token field, paste the token from step 1.
  6. Click Test connection. If the credentials are correct, a "Connection established" message appears.
  7. Save the project integration.

Verify the integration

Use both — a link flow and a defect flow:

  1. Open a test case in Allure TestOps and add an issue link.
    1. Confirm that the Linear picker can find tasks from Linear side based on task ID or partial issue name.
  2. Open an Allure TestOps Launch (Edit) add an issue link.
    1. Confirm that the Linear picker can find tasks from Linear side based on task ID or partial issue name.
  3. Open a defect in TestOps and confirm that the Linear integration can either create new tasks or link defect to existing tasks on Linear side.
© Qameta Software Inc. All rights reserved.