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"
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

API reference (v2)

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"
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

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 merge-queue permissions it holds; a key with none can read merge queues but change nothing. Those permissions scope merge queue only: every key can use the Flaky Tests and Dynamic CI endpoints, including their writes, whatever permissions it holds.

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"