Skip to main content

Documentation Index

Fetch the complete documentation index at: https://trunk-4cab4936-mintlify-migrate-trunk-docs-1778256504.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

When Trunk Flaky Tests detects a flaky test, you can create an automatically generated Linear ticket for your team to pick up and fix the test. Webhook payloads will also contain ticket information when a Jira ticket is created with the integration or when existing tickets are linked.

​
Connecting to Linear

To connect a Linear project:
  1. Navigate to Settings > Repositories > Ticketing Integration.
  2. Select Linear as your Ticketing System.
  3. Add a Linear API key
  4. Select a Team and Connect to Linear.
After connecting to Linear, you can specify a default project and a default assignee for new tickets.

​
API Key permissions

The following project permissions must be granted to your Linear API key so Trunk can read, create, and assign tickets automatically:
  • Read
  • Create issues
Selecting Full Access will also grant the required permissions.

​
Create a new ticket

You can create a new ticket for any test listed in Flaky Tests. There are 2 ways to create a new ticket in the Flaky Test dashboard:
  • Click on the options menu for any test case on the repo overview dashboard
Before you create the ticket, you get a preview of the title and description.

​
Create with Linear

If you are connected to Linear, you can click the Create Linear Ticket button at the end of the modal to automatically create a ticket with the configured team and assignees. Note: You can use Flaky Tests webhooks to automate ticket creation, or if you need more control over how tickets are created in Linear. This integration is not required when using webhooks. If you already have a ticket in Linear that you want to link to a test in the dashboard, you can use the Link Ticket to Test Case API.