Create a ticket for a test

curl --request POST \
  --url https://api.trunk.io/v2/tests/{testId}/create-ticket \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "[Flaky Test] suite::test_case_name",
  "description": "See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)",
  "fields": {
    "assignee": "5b10ac8d82e05b22cc7d4ef5"
  },
  "replaceExisting": false
}
'

import requests

url = "https://api.trunk.io/v2/tests/{testId}/create-ticket"

payload = {
    "title": "[Flaky Test] suite::test_case_name",
    "description": "See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)",
    "fields": { "assignee": "5b10ac8d82e05b22cc7d4ef5" },
    "replaceExisting": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: '[Flaky Test] suite::test_case_name',
    description: 'See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)',
    fields: {assignee: '5b10ac8d82e05b22cc7d4ef5'},
    replaceExisting: false
  })
};

fetch('https://api.trunk.io/v2/tests/{testId}/create-ticket', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trunk.io/v2/tests/{testId}/create-ticket",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => '[Flaky Test] suite::test_case_name',
    'description' => 'See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)',
    'fields' => [
        'assignee' => '5b10ac8d82e05b22cc7d4ef5'
    ],
    'replaceExisting' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trunk.io/v2/tests/{testId}/create-ticket"

	payload := strings.NewReader("{\n  \"title\": \"[Flaky Test] suite::test_case_name\",\n  \"description\": \"See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)\",\n  \"fields\": {\n    \"assignee\": \"5b10ac8d82e05b22cc7d4ef5\"\n  },\n  \"replaceExisting\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.trunk.io/v2/tests/{testId}/create-ticket")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"[Flaky Test] suite::test_case_name\",\n  \"description\": \"See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)\",\n  \"fields\": {\n    \"assignee\": \"5b10ac8d82e05b22cc7d4ef5\"\n  },\n  \"replaceExisting\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trunk.io/v2/tests/{testId}/create-ticket")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"[Flaky Test] suite::test_case_name\",\n  \"description\": \"See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)\",\n  \"fields\": {\n    \"assignee\": \"5b10ac8d82e05b22cc7d4ef5\"\n  },\n  \"replaceExisting\": false\n}"

response = http.request(request)
puts response.read_body

{
  "id": "5d4c3b2a-1f0e-4a1b-8c9d-0e1f2a3b4c5d",
  "provider": "jiraCloud",
  "key": "TRUNK-1234",
  "url": "https://acme.atlassian.net/browse/TRUNK-1234",
  "title": "[Flaky Test] suite::test_case_name",
  "status": "In Progress",
  "assignee": "Ada Lovelace",
  "syncedAt": "2026-09-15T14:45:01.000Z"
}

Tests

Create a ticket for a test

Files a new ticket in the test collection’s default ticketing connection and links it to a test, returning the ticket as Trunk now holds it. A collection with no default connection is refused with TICKETING_NOT_CONFIGURED.

The ticket gets the default fields saved on that connection, with fields merged over them. The provider may still refuse the ticket: a field it does not accept, or a required one neither sets, is 422 TICKET_FIELDS_REJECTED with the provider’s own message, and a connection the provider will not let create tickets (no access to its project, a missing scope, a plan limit) is 409 TICKETING_CREATE_REFUSED.

A title or description you leave out is generated the way the web app generates it: the test’s location, failure rate, owners and most common failure reasons, with a link back to the test. Failure summaries are left out while your organization has AI features turned off. A test with no data to generate from is refused with TICKET_CONTENT_UNAVAILABLE; pass both to create its ticket anyway.

A test carries at most one ticket. If one is already linked, the call is refused with TEST_ALREADY_LINKED and files nothing, unless replaceExisting is true.

Idempotency-Key is not honored. The call files the ticket with the provider and answers 504 if that takes longer than five seconds; a 504 does not mean nothing was filed. Before retrying, read the test (GET /v2/tests/{testId}): if its ticket is set, the ticket was created and linked. A 502 UPSTREAM_ERROR means the provider did not answer; when it was rate-limiting, Retry-After says how long to wait.

A test in another organization is reported as 404, not 403, and so is a malformed id.

POST

tests

{testId}

create-ticket

Create a ticket for a test

curl --request POST \
  --url https://api.trunk.io/v2/tests/{testId}/create-ticket \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "[Flaky Test] suite::test_case_name",
  "description": "See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)",
  "fields": {
    "assignee": "5b10ac8d82e05b22cc7d4ef5"
  },
  "replaceExisting": false
}
'

import requests

url = "https://api.trunk.io/v2/tests/{testId}/create-ticket"

payload = {
    "title": "[Flaky Test] suite::test_case_name",
    "description": "See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)",
    "fields": { "assignee": "5b10ac8d82e05b22cc7d4ef5" },
    "replaceExisting": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: '[Flaky Test] suite::test_case_name',
    description: 'See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)',
    fields: {assignee: '5b10ac8d82e05b22cc7d4ef5'},
    replaceExisting: false
  })
};

fetch('https://api.trunk.io/v2/tests/{testId}/create-ticket', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trunk.io/v2/tests/{testId}/create-ticket",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => '[Flaky Test] suite::test_case_name',
    'description' => 'See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)',
    'fields' => [
        'assignee' => '5b10ac8d82e05b22cc7d4ef5'
    ],
    'replaceExisting' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trunk.io/v2/tests/{testId}/create-ticket"

	payload := strings.NewReader("{\n  \"title\": \"[Flaky Test] suite::test_case_name\",\n  \"description\": \"See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)\",\n  \"fields\": {\n    \"assignee\": \"5b10ac8d82e05b22cc7d4ef5\"\n  },\n  \"replaceExisting\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.trunk.io/v2/tests/{testId}/create-ticket")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"[Flaky Test] suite::test_case_name\",\n  \"description\": \"See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)\",\n  \"fields\": {\n    \"assignee\": \"5b10ac8d82e05b22cc7d4ef5\"\n  },\n  \"replaceExisting\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trunk.io/v2/tests/{testId}/create-ticket")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"[Flaky Test] suite::test_case_name\",\n  \"description\": \"See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)\",\n  \"fields\": {\n    \"assignee\": \"5b10ac8d82e05b22cc7d4ef5\"\n  },\n  \"replaceExisting\": false\n}"

response = http.request(request)
puts response.read_body

{
  "id": "5d4c3b2a-1f0e-4a1b-8c9d-0e1f2a3b4c5d",
  "provider": "jiraCloud",
  "key": "TRUNK-1234",
  "url": "https://acme.atlassian.net/browse/TRUNK-1234",
  "title": "[Flaky Test] suite::test_case_name",
  "status": "In Progress",
  "assignee": "Ada Lovelace",
  "syncedAt": "2026-09-15T14:45:01.000Z"
}

Authorizations

Authorization

string

header

required

An API key, sent as Authorization: Bearer <key>. An organization admin creates one in the Trunk app under Settings → Developer → API Keys and chooses the permissions it holds. A key with none can read merge queues but change nothing in them. Permissions cover merge queues and test-result uploads, including the quarantine lookups a CI run makes before it uploads; any key can call the other Flaky Tests and Dynamic CI endpoints, including their writes.

Path Parameters

testId

string

required

The test's globally unique id.

Minimum string length: 1

Example:

"bfeebcf4-0000-8000-8000-000000000001"

Body

application/json

The ticket to create for a test in a test collection.

title

string

The ticket's title. Defaults to the one the web app generates, such as [Flaky Test] suite::test_case_name.

Required string length: 1 - 250

Example:

"[Flaky Test] suite::test_case_name"

description

string

The ticket's body, in Markdown. Defaults to the one the web app generates: the test's location, failure rate, owners and most common failure reasons, with a link back to the test in Trunk.

Example:

"See all details on the [Trunk Test Detail page](https://app.trunk.io/acme/flaky-tests/collections/ab12cd34/tests/bfeebcf4-0000-8000-8000-000000000001)"

fields

object

Provider fields to set on the ticket, keyed by the provider's field id (a Jira custom field id, assignee, a Linear project id), in the shape the provider takes. Merged over the default fields saved on the collection's ticketing connection; a field set here wins.

Show child attributes

Example:

{ "assignee": "5b10ac8d82e05b22cc7d4ef5" }

replaceExisting

boolean

Replace a ticket already linked to the test. When false or absent, a test that has a ticket is refused with TEST_ALREADY_LINKED.

Example:

false

Response

The created and linked ticket

string

required

Trunk's id for the linked ticket.

Example:

"5d4c3b2a-1f0e-4a1b-8c9d-0e1f2a3b4c5d"

provider

enum<string>

required

The ticketing system a ticket lives in.

Available options:

jiraCloud,

linear,

asana,

jiraDataCenter

Example:

"jiraCloud"

key

string

required

The provider's human-readable key. Mutable on some providers (a Jira issue moved between projects gets a new one).

Example:

"TRUNK-1234"

url

string<uri>

required

Example:

"https://acme.atlassian.net/browse/TRUNK-1234"

title

string

required

Example:

"[Flaky Test] suite::test_case_name"

status

string

required

The provider's status name, as last synced.

Example:

"In Progress"

assignee

string | null

required

The provider's assignee display name; null when unassigned.

Example:

"Ada Lovelace"

syncedAt

string<date-time>

required

When Trunk last read the ticket back from its provider.

Example:

"2026-09-15T14:45:01.000Z"