Link a ticket to a test case

curl --request POST \
  --url https://api.trunk.io/v2/test-cases/{testCaseId}/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/test-cases/{testCaseId}/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/test-cases/{testCaseId}/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/test-cases/{testCaseId}/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/test-cases/{testCaseId}/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/test-cases/{testCaseId}/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/test-cases/{testCaseId}/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 case

Links an existing ticket from one of your organization’s ticketing connections to a test case, 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 case 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 case in another organization is reported as 404, not 403, and so is a malformed id.

POST

test-cases

{testCaseId}

ticket

Link a ticket to a test case

curl --request POST \
  --url https://api.trunk.io/v2/test-cases/{testCaseId}/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/test-cases/{testCaseId}/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/test-cases/{testCaseId}/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/test-cases/{testCaseId}/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/test-cases/{testCaseId}/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/test-cases/{testCaseId}/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/test-cases/{testCaseId}/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 org-scoped API key, sent as Authorization: Bearer <key>. Existing v1 tokens work here unchanged. There is no enqueue-only or read/write scope: an org key authorized for merge-queue writes can invoke every merge-queue mutation, including changing merge-protection configuration and pausing, draining or deleting a queue.

Path Parameters

testCaseId

string

required

The test case's globally unique id.

Minimum string length: 1

Example:

"bfeebcf4-0000-8000-8000-000000000001"

Body

application/json

The ticket to link to a test case 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"