Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trunk.io/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, you can configure field defaults for auto-created tickets — including Priority, Labels, Estimate, Project, and Assignee — all scoped to the selected team. See Field defaults below.

​
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 Tests 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 any field defaults you have set. 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.

​
Field defaults

After selecting a team, you can configure default values that pre-populate whenever a new Linear ticket is created from Flaky Tests:
FieldDescription
PriorityDefault issue priority (Urgent, High, Medium, Low, No priority)
LabelsOne or more team-level or workspace-level labels to apply
EstimateDefault story point estimate (scale matches your team’s estimation type: Fibonacci, T-shirt, linear, or exponential)
ProjectDefault Linear project, filtered to projects accessible by the selected team
AssigneeDefault assignee, chosen from team members
Changing the selected team clears and reloads all field options automatically. Field defaults are saved per repository. When you open the Create Ticket modal, all configured defaults are pre-filled and can be overridden before submitting. If you already have a Linear ticket for a test, you can link it directly from the Test Details page without creating a new one. From the UI:
  1. Open the test case details page.
  2. Click Link Ticket in the top-left corner.
  3. Enter the Linear ticket URL or ID and click Submit.
The ticket appears on the test details page and its metadata (title, status, assignee) syncs from Linear. Via API: You can also link tickets programmatically using the Link Ticket to Test Case API.