Link a ticket to a test

curl --request POST \
  --url https://api.trunk.io/v2/tests/{testId}/ticket \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalTicketId": "TRUNK-1234",
  "integrationId": "2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d"
}
'

import requests

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

payload = {
    "externalTicketId": "TRUNK-1234",
    "integrationId": "2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d"
}
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({
    externalTicketId: 'TRUNK-1234',
    integrationId: '2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d'
  })
};

fetch('https://api.trunk.io/v2/tests/{testId}/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}/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([
    'externalTicketId' => 'TRUNK-1234',
    'integrationId' => '2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d'
  ]),
  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}/ticket"

	payload := strings.NewReader("{\n  \"externalTicketId\": \"TRUNK-1234\",\n  \"integrationId\": \"2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d\"\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}/ticket")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"externalTicketId\": \"TRUNK-1234\",\n  \"integrationId\": \"2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trunk.io/v2/tests/{testId}/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  \"externalTicketId\": \"TRUNK-1234\",\n  \"integrationId\": \"2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d\"\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)

Link a ticket to a test

Links an existing ticket from one of your organization’s ticketing connections to a test, and returns the ticket as Trunk now holds it. The ticket is fetched from its provider first, so a key or URL the provider does not recognize is refused.

A test carries at most one ticket. Linking replaces any ticket already linked; linking the one already there changes nothing. Which connection is used is integrationId, defaulting to the collection’s default connection — with no default and no integrationId, the call is refused with TICKETING_NOT_CONFIGURED.

The call round-trips to the ticketing provider twice (to validate the connection, then to fetch the ticket) and answers 504 if that takes longer than five seconds. A 504 does not mean the link failed — retry it; re-linking the same ticket is a no-op. 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}

ticket

Link a ticket to a test

curl --request POST \
  --url https://api.trunk.io/v2/tests/{testId}/ticket \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalTicketId": "TRUNK-1234",
  "integrationId": "2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d"
}
'

import requests

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

payload = {
    "externalTicketId": "TRUNK-1234",
    "integrationId": "2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d"
}
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({
    externalTicketId: 'TRUNK-1234',
    integrationId: '2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d'
  })
};

fetch('https://api.trunk.io/v2/tests/{testId}/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}/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([
    'externalTicketId' => 'TRUNK-1234',
    'integrationId' => '2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d'
  ]),
  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}/ticket"

	payload := strings.NewReader("{\n  \"externalTicketId\": \"TRUNK-1234\",\n  \"integrationId\": \"2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d\"\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}/ticket")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"externalTicketId\": \"TRUNK-1234\",\n  \"integrationId\": \"2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trunk.io/v2/tests/{testId}/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  \"externalTicketId\": \"TRUNK-1234\",\n  \"integrationId\": \"2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d\"\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 link to a test in a test collection.

externalTicketId

string

required

The ticket to link, as its provider key (TRUNK-123, a Linear identifier, an Asana task gid) or as its browser URL — either form is accepted.

Required string length: 1 - 2048

Example:

"TRUNK-1234"

integrationId

string<uuid>

Which of the organization's ticketing connections the ticket lives on. Defaults to the collection's default connection.

Example:

"2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d"

Response

The 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

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"