Update a merge queue's configuration

curl --request PATCH \
  --url https://api.trunk.io/v2/merge-queues/{id}/config \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "concurrency": 500,
  "bisectionConcurrency": 500,
  "pendingFailureDepth": 500,
  "canOptimisticallyMerge": true,
  "allowBatching": true,
  "batchingMaxWaitTimeMinutes": 5040,
  "batchingMinSize": 500,
  "testingTimeoutMinutes": 5040,
  "notReadyTimeoutMinutes": 21600,
  "createsPrsForTestingBranches": true,
  "areCommentsEnabled": true,
  "areCommandsEnabled": true,
  "isStatusCheckEnabled": true,
  "isExtensionEnabled": true,
  "areLabelCommandsEnabled": true,
  "areStateLabelsEnabled": true,
  "requiredStatuses": [
    "<string>"
  ],
  "batchingRules": [
    {
      "targetPattern": "<string>",
      "policy": "isolate"
    }
  ],
  "enqueueingLabel": "<string>"
}
'

import requests

url = "https://api.trunk.io/v2/merge-queues/{id}/config"

payload = {
    "concurrency": 500,
    "bisectionConcurrency": 500,
    "pendingFailureDepth": 500,
    "canOptimisticallyMerge": True,
    "allowBatching": True,
    "batchingMaxWaitTimeMinutes": 5040,
    "batchingMinSize": 500,
    "testingTimeoutMinutes": 5040,
    "notReadyTimeoutMinutes": 21600,
    "createsPrsForTestingBranches": True,
    "areCommentsEnabled": True,
    "areCommandsEnabled": True,
    "isStatusCheckEnabled": True,
    "isExtensionEnabled": True,
    "areLabelCommandsEnabled": True,
    "areStateLabelsEnabled": True,
    "requiredStatuses": ["<string>"],
    "batchingRules": [
        {
            "targetPattern": "<string>",
            "policy": "isolate"
        }
    ],
    "enqueueingLabel": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    concurrency: 500,
    bisectionConcurrency: 500,
    pendingFailureDepth: 500,
    canOptimisticallyMerge: true,
    allowBatching: true,
    batchingMaxWaitTimeMinutes: 5040,
    batchingMinSize: 500,
    testingTimeoutMinutes: 5040,
    notReadyTimeoutMinutes: 21600,
    createsPrsForTestingBranches: true,
    areCommentsEnabled: true,
    areCommandsEnabled: true,
    isStatusCheckEnabled: true,
    isExtensionEnabled: true,
    areLabelCommandsEnabled: true,
    areStateLabelsEnabled: true,
    requiredStatuses: ['<string>'],
    batchingRules: [{targetPattern: '<string>', policy: 'isolate'}],
    enqueueingLabel: '<string>'
  })
};

fetch('https://api.trunk.io/v2/merge-queues/{id}/config', 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/merge-queues/{id}/config",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'concurrency' => 500,
    'bisectionConcurrency' => 500,
    'pendingFailureDepth' => 500,
    'canOptimisticallyMerge' => true,
    'allowBatching' => true,
    'batchingMaxWaitTimeMinutes' => 5040,
    'batchingMinSize' => 500,
    'testingTimeoutMinutes' => 5040,
    'notReadyTimeoutMinutes' => 21600,
    'createsPrsForTestingBranches' => true,
    'areCommentsEnabled' => true,
    'areCommandsEnabled' => true,
    'isStatusCheckEnabled' => true,
    'isExtensionEnabled' => true,
    'areLabelCommandsEnabled' => true,
    'areStateLabelsEnabled' => true,
    'requiredStatuses' => [
        '<string>'
    ],
    'batchingRules' => [
        [
                'targetPattern' => '<string>',
                'policy' => 'isolate'
        ]
    ],
    'enqueueingLabel' => '<string>'
  ]),
  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/merge-queues/{id}/config"

	payload := strings.NewReader("{\n  \"concurrency\": 500,\n  \"bisectionConcurrency\": 500,\n  \"pendingFailureDepth\": 500,\n  \"canOptimisticallyMerge\": true,\n  \"allowBatching\": true,\n  \"batchingMaxWaitTimeMinutes\": 5040,\n  \"batchingMinSize\": 500,\n  \"testingTimeoutMinutes\": 5040,\n  \"notReadyTimeoutMinutes\": 21600,\n  \"createsPrsForTestingBranches\": true,\n  \"areCommentsEnabled\": true,\n  \"areCommandsEnabled\": true,\n  \"isStatusCheckEnabled\": true,\n  \"isExtensionEnabled\": true,\n  \"areLabelCommandsEnabled\": true,\n  \"areStateLabelsEnabled\": true,\n  \"requiredStatuses\": [\n    \"<string>\"\n  ],\n  \"batchingRules\": [\n    {\n      \"targetPattern\": \"<string>\",\n      \"policy\": \"isolate\"\n    }\n  ],\n  \"enqueueingLabel\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://api.trunk.io/v2/merge-queues/{id}/config")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"concurrency\": 500,\n  \"bisectionConcurrency\": 500,\n  \"pendingFailureDepth\": 500,\n  \"canOptimisticallyMerge\": true,\n  \"allowBatching\": true,\n  \"batchingMaxWaitTimeMinutes\": 5040,\n  \"batchingMinSize\": 500,\n  \"testingTimeoutMinutes\": 5040,\n  \"notReadyTimeoutMinutes\": 21600,\n  \"createsPrsForTestingBranches\": true,\n  \"areCommentsEnabled\": true,\n  \"areCommandsEnabled\": true,\n  \"isStatusCheckEnabled\": true,\n  \"isExtensionEnabled\": true,\n  \"areLabelCommandsEnabled\": true,\n  \"areStateLabelsEnabled\": true,\n  \"requiredStatuses\": [\n    \"<string>\"\n  ],\n  \"batchingRules\": [\n    {\n      \"targetPattern\": \"<string>\",\n      \"policy\": \"isolate\"\n    }\n  ],\n  \"enqueueingLabel\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trunk.io/v2/merge-queues/{id}/config")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"concurrency\": 500,\n  \"bisectionConcurrency\": 500,\n  \"pendingFailureDepth\": 500,\n  \"canOptimisticallyMerge\": true,\n  \"allowBatching\": true,\n  \"batchingMaxWaitTimeMinutes\": 5040,\n  \"batchingMinSize\": 500,\n  \"testingTimeoutMinutes\": 5040,\n  \"notReadyTimeoutMinutes\": 21600,\n  \"createsPrsForTestingBranches\": true,\n  \"areCommentsEnabled\": true,\n  \"areCommandsEnabled\": true,\n  \"isStatusCheckEnabled\": true,\n  \"isExtensionEnabled\": true,\n  \"areLabelCommandsEnabled\": true,\n  \"areStateLabelsEnabled\": true,\n  \"requiredStatuses\": [\n    \"<string>\"\n  ],\n  \"batchingRules\": [\n    {\n      \"targetPattern\": \"<string>\",\n      \"policy\": \"isolate\"\n    }\n  ],\n  \"enqueueingLabel\": \"<string>\"\n}"

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

{
  "id": "xK9mP2nQ",
  "repositoryId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "targetBranch": "main",
  "state": "running",
  "mode": "queue",
  "managedState": "manual",
  "createdAt": "2026-07-24T20:26:04.000Z",
  "updatedAt": "2026-07-28T11:02:31.000Z",
  "repositoryUrl": "https://github.com/acme/widgets",
  "pullRequestsUrl": "/v2/merge-queues/xK9mP2nQ/pull-requests",
  "config": {
    "concurrency": 5,
    "bisectionConcurrency": 0,
    "pendingFailureDepth": 3,
    "canOptimisticallyMerge": true,
    "allowBatching": false,
    "batchingMaxWaitTimeMinutes": 10,
    "batchingMinSize": 2,
    "testingTimeoutMinutes": 60,
    "notReadyTimeoutMinutes": 120,
    "createsPrsForTestingBranches": false,
    "areCommentsEnabled": true,
    "areCommandsEnabled": true,
    "isStatusCheckEnabled": true,
    "isExtensionEnabled": false,
    "areLabelCommandsEnabled": true,
    "areStateLabelsEnabled": true,
    "requiredStatuses": [
      "build",
      "lint"
    ],
    "batchingRules": [
      {
        "targetPattern": "//db/migrations:*",
        "policy": "isolate"
      }
    ],
    "directMergeMode": "off",
    "optimizationMode": "off",
    "mergeMethod": "squash",
    "testBranchConstructionMode": "renameTempBranch",
    "enqueueingLabel": "trunk-merge"
  },
  "htmlUrl": "https://app.trunk.io/acme/merge-queue/xK9mP2nQ"
}

Merge queues

Update a merge queue's configuration

Requires the Update Merge Queue settings permission. Applies a JSON Merge Patch to the queue’s configuration: an absent key leaves that setting unchanged, and an unknown key is rejected rather than silently dropped. Send requiredStatuses: [] or batchingRules: [] to clear those lists.

requiredStatuses is a merge-protection control, not a tuning knob: it decides what must pass before an entry may merge (clearing it falls back to .trunk/trunk.yaml and the branch’s protection rules). Treat access to this endpoint as security-relevant. Refused with MODE_CHANGE_IN_PROGRESS while the queue is converting between modes, and with ALLOWED_BOT_SUBMITTERS_FROZEN for a body carrying the removed allowedBotSubmitters: bots are approved on the Bots page of the organization’s settings.

PATCH

merge-queues

{id}

config

Update a merge queue's configuration

curl --request PATCH \
  --url https://api.trunk.io/v2/merge-queues/{id}/config \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "concurrency": 500,
  "bisectionConcurrency": 500,
  "pendingFailureDepth": 500,
  "canOptimisticallyMerge": true,
  "allowBatching": true,
  "batchingMaxWaitTimeMinutes": 5040,
  "batchingMinSize": 500,
  "testingTimeoutMinutes": 5040,
  "notReadyTimeoutMinutes": 21600,
  "createsPrsForTestingBranches": true,
  "areCommentsEnabled": true,
  "areCommandsEnabled": true,
  "isStatusCheckEnabled": true,
  "isExtensionEnabled": true,
  "areLabelCommandsEnabled": true,
  "areStateLabelsEnabled": true,
  "requiredStatuses": [
    "<string>"
  ],
  "batchingRules": [
    {
      "targetPattern": "<string>",
      "policy": "isolate"
    }
  ],
  "enqueueingLabel": "<string>"
}
'

import requests

url = "https://api.trunk.io/v2/merge-queues/{id}/config"

payload = {
    "concurrency": 500,
    "bisectionConcurrency": 500,
    "pendingFailureDepth": 500,
    "canOptimisticallyMerge": True,
    "allowBatching": True,
    "batchingMaxWaitTimeMinutes": 5040,
    "batchingMinSize": 500,
    "testingTimeoutMinutes": 5040,
    "notReadyTimeoutMinutes": 21600,
    "createsPrsForTestingBranches": True,
    "areCommentsEnabled": True,
    "areCommandsEnabled": True,
    "isStatusCheckEnabled": True,
    "isExtensionEnabled": True,
    "areLabelCommandsEnabled": True,
    "areStateLabelsEnabled": True,
    "requiredStatuses": ["<string>"],
    "batchingRules": [
        {
            "targetPattern": "<string>",
            "policy": "isolate"
        }
    ],
    "enqueueingLabel": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    concurrency: 500,
    bisectionConcurrency: 500,
    pendingFailureDepth: 500,
    canOptimisticallyMerge: true,
    allowBatching: true,
    batchingMaxWaitTimeMinutes: 5040,
    batchingMinSize: 500,
    testingTimeoutMinutes: 5040,
    notReadyTimeoutMinutes: 21600,
    createsPrsForTestingBranches: true,
    areCommentsEnabled: true,
    areCommandsEnabled: true,
    isStatusCheckEnabled: true,
    isExtensionEnabled: true,
    areLabelCommandsEnabled: true,
    areStateLabelsEnabled: true,
    requiredStatuses: ['<string>'],
    batchingRules: [{targetPattern: '<string>', policy: 'isolate'}],
    enqueueingLabel: '<string>'
  })
};

fetch('https://api.trunk.io/v2/merge-queues/{id}/config', 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/merge-queues/{id}/config",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'concurrency' => 500,
    'bisectionConcurrency' => 500,
    'pendingFailureDepth' => 500,
    'canOptimisticallyMerge' => true,
    'allowBatching' => true,
    'batchingMaxWaitTimeMinutes' => 5040,
    'batchingMinSize' => 500,
    'testingTimeoutMinutes' => 5040,
    'notReadyTimeoutMinutes' => 21600,
    'createsPrsForTestingBranches' => true,
    'areCommentsEnabled' => true,
    'areCommandsEnabled' => true,
    'isStatusCheckEnabled' => true,
    'isExtensionEnabled' => true,
    'areLabelCommandsEnabled' => true,
    'areStateLabelsEnabled' => true,
    'requiredStatuses' => [
        '<string>'
    ],
    'batchingRules' => [
        [
                'targetPattern' => '<string>',
                'policy' => 'isolate'
        ]
    ],
    'enqueueingLabel' => '<string>'
  ]),
  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/merge-queues/{id}/config"

	payload := strings.NewReader("{\n  \"concurrency\": 500,\n  \"bisectionConcurrency\": 500,\n  \"pendingFailureDepth\": 500,\n  \"canOptimisticallyMerge\": true,\n  \"allowBatching\": true,\n  \"batchingMaxWaitTimeMinutes\": 5040,\n  \"batchingMinSize\": 500,\n  \"testingTimeoutMinutes\": 5040,\n  \"notReadyTimeoutMinutes\": 21600,\n  \"createsPrsForTestingBranches\": true,\n  \"areCommentsEnabled\": true,\n  \"areCommandsEnabled\": true,\n  \"isStatusCheckEnabled\": true,\n  \"isExtensionEnabled\": true,\n  \"areLabelCommandsEnabled\": true,\n  \"areStateLabelsEnabled\": true,\n  \"requiredStatuses\": [\n    \"<string>\"\n  ],\n  \"batchingRules\": [\n    {\n      \"targetPattern\": \"<string>\",\n      \"policy\": \"isolate\"\n    }\n  ],\n  \"enqueueingLabel\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://api.trunk.io/v2/merge-queues/{id}/config")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"concurrency\": 500,\n  \"bisectionConcurrency\": 500,\n  \"pendingFailureDepth\": 500,\n  \"canOptimisticallyMerge\": true,\n  \"allowBatching\": true,\n  \"batchingMaxWaitTimeMinutes\": 5040,\n  \"batchingMinSize\": 500,\n  \"testingTimeoutMinutes\": 5040,\n  \"notReadyTimeoutMinutes\": 21600,\n  \"createsPrsForTestingBranches\": true,\n  \"areCommentsEnabled\": true,\n  \"areCommandsEnabled\": true,\n  \"isStatusCheckEnabled\": true,\n  \"isExtensionEnabled\": true,\n  \"areLabelCommandsEnabled\": true,\n  \"areStateLabelsEnabled\": true,\n  \"requiredStatuses\": [\n    \"<string>\"\n  ],\n  \"batchingRules\": [\n    {\n      \"targetPattern\": \"<string>\",\n      \"policy\": \"isolate\"\n    }\n  ],\n  \"enqueueingLabel\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trunk.io/v2/merge-queues/{id}/config")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"concurrency\": 500,\n  \"bisectionConcurrency\": 500,\n  \"pendingFailureDepth\": 500,\n  \"canOptimisticallyMerge\": true,\n  \"allowBatching\": true,\n  \"batchingMaxWaitTimeMinutes\": 5040,\n  \"batchingMinSize\": 500,\n  \"testingTimeoutMinutes\": 5040,\n  \"notReadyTimeoutMinutes\": 21600,\n  \"createsPrsForTestingBranches\": true,\n  \"areCommentsEnabled\": true,\n  \"areCommandsEnabled\": true,\n  \"isStatusCheckEnabled\": true,\n  \"isExtensionEnabled\": true,\n  \"areLabelCommandsEnabled\": true,\n  \"areStateLabelsEnabled\": true,\n  \"requiredStatuses\": [\n    \"<string>\"\n  ],\n  \"batchingRules\": [\n    {\n      \"targetPattern\": \"<string>\",\n      \"policy\": \"isolate\"\n    }\n  ],\n  \"enqueueingLabel\": \"<string>\"\n}"

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

{
  "id": "xK9mP2nQ",
  "repositoryId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "targetBranch": "main",
  "state": "running",
  "mode": "queue",
  "managedState": "manual",
  "createdAt": "2026-07-24T20:26:04.000Z",
  "updatedAt": "2026-07-28T11:02:31.000Z",
  "repositoryUrl": "https://github.com/acme/widgets",
  "pullRequestsUrl": "/v2/merge-queues/xK9mP2nQ/pull-requests",
  "config": {
    "concurrency": 5,
    "bisectionConcurrency": 0,
    "pendingFailureDepth": 3,
    "canOptimisticallyMerge": true,
    "allowBatching": false,
    "batchingMaxWaitTimeMinutes": 10,
    "batchingMinSize": 2,
    "testingTimeoutMinutes": 60,
    "notReadyTimeoutMinutes": 120,
    "createsPrsForTestingBranches": false,
    "areCommentsEnabled": true,
    "areCommandsEnabled": true,
    "isStatusCheckEnabled": true,
    "isExtensionEnabled": false,
    "areLabelCommandsEnabled": true,
    "areStateLabelsEnabled": true,
    "requiredStatuses": [
      "build",
      "lint"
    ],
    "batchingRules": [
      {
        "targetPattern": "//db/migrations:*",
        "policy": "isolate"
      }
    ],
    "directMergeMode": "off",
    "optimizationMode": "off",
    "mergeMethod": "squash",
    "testBranchConstructionMode": "renameTempBranch",
    "enqueueingLabel": "trunk-merge"
  },
  "htmlUrl": "https://app.trunk.io/acme/merge-queue/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 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

string

required

The merge queue's id.

Example:

"xK9mP2nQ"

Body

application/json

A JSON Merge Patch: an absent key leaves that setting unchanged, and an unknown key is rejected rather than dropped. requiredStatuses: [] and batchingRules: [] clear those lists. A batchingRules write replaces the whole set. notReadyTimeoutMinutes must be a whole number of hours.

concurrency

integer

How many entries the queue may verify at once. Higher values merge faster and cost more CI.

Required range: 1 <= x <= 1000

bisectionConcurrency

integer

How many verification runs the engine may use in parallel when bisecting a failed batch. 0 means bisection gets no dedicated capacity and shares concurrency.

Required range: 0 <= x <= 1000

pendingFailureDepth

integer

How many test runs behind an entry in pendingFailure may keep testing while it waits; a passing run behind it shows the failure was not its own. Applies with canOptimisticallyMerge. 0 means nothing behind a pending failure tests until it resolves.

Required range: 0 <= x <= 1000

canOptimisticallyMerge

boolean

Whether an entry whose own verification passed may merge before every entry ahead of it has merged, when the engine can prove the result still holds.

allowBatching

boolean

Whether the queue may verify several entries together in one run. Batching is cheaper but a failure must then be attributed by bisection. An individual entry can opt out at submit time; the queue setting is the ceiling, so an entry cannot batch when this is false.

batchingMaxWaitTimeMinutes

integer

How long the queue waits for more entries before starting a batch smaller than batchingMinSize. 0 means never wait — start as soon as there is anything to test.

Required range: 0 <= x <= 10080

batchingMinSize

integer

The batch size the queue prefers before starting a run, subject to batchingMaxWaitTimeMinutes. At least 1.

Required range: 1 <= x <= 1000

testingTimeoutMinutes

integer

How long a verification run may take before the queue abandons it and fails the entry. 0 means no timeout — a stuck run will hold its slot indefinitely.

Required range: 0 <= x <= 10080

notReadyTimeoutMinutes

integer

How long an entry may sit notReady before the queue cancels it (NOT_READY_TIMEOUT_EXPIRED). 0 means no timeout. Stored as whole hours, so this must be a multiple of 60.

Required range: 0 <= x <= 43200

createsPrsForTestingBranches

boolean

Whether the queue opens a provider pull request for each testing branch it creates. Makes runs visible in the provider UI at the cost of extra pull-request noise.

areCommentsEnabled

boolean

Whether the queue posts status comments on pull requests it processes.

areCommandsEnabled

boolean

Whether the queue acts on comment commands (e.g. a comment asking to enqueue or dequeue).

isStatusCheckEnabled

boolean

Whether the queue publishes its own status check onto each pull request, so its state is visible in the provider's merge box.

isExtensionEnabled

boolean

Whether Trunk's browser extension surfaces queue controls on this repository's pull requests.

areLabelCommandsEnabled

boolean

Whether applying enqueueingLabel to a pull request submits it to this queue.

areStateLabelsEnabled

boolean

Whether the queue maintains labels reflecting each entry's state. Trunk owns labels prefixed trunk-, which is why enqueueingLabel may not collide with that prefix.

requiredStatuses

string[]

The provider check names that must pass for an entry to be considered verified. Empty means the queue takes required statuses from .trunk/trunk.yaml, then from the branch's protection rules. If .trunk/trunk.yaml doesn't set them and the branch requires no checks, the entry fails with START_TEST_RUN_NO_REQUIRED_STATUSES; an explicit empty list in .trunk/trunk.yaml gates on nothing. Security-relevant: this is the queue's merge gate.

Maximum array length: 100

Minimum string length: 1

batchingRules

object[]

Rules changing how pull requests are batched based on the build targets they impact. Empty means every entry batches normally. Applies to queues in graph mode that upload impacted targets.

Maximum array length: 100

Show child attributes

directMergeMode

enum<string>

One of off or always. See the DirectMergeMode schema.

Available options:

off,

always

optimizationMode

enum<string>

One of off or bisectionSkipRedundantTests. See the OptimizationMode schema.

Available options:

off,

bisectionSkipRedundantTests

mergeMethod

enum<string>

One of mergeCommit, squash, or rebase. See the MergeMethod schema.

Available options:

mergeCommit,

squash,

rebase

testBranchConstructionMode

enum<string>

One of renameTempBranch or pushNewBranchFromTemp. See the TestBranchConstructionMode schema.

Available options:

renameTempBranch,

pushNewBranchFromTemp

enqueueingLabel

string

The label that submits a pull request to this queue when areLabelCommandsEnabled is true. May not collide with a Trunk-reserved trunk-* state label.

Minimum string length: 1

Response

The updated merge queue

string

required

Example:

"xK9mP2nQ"

repositoryId

string

required

Resolve with GET /v2/repositories/{id}.

Example:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

targetBranch

string

required

Example:

"main"

state

enum<string>

required

The queue's lifecycle state. switchingModes is a transient conversion state during which config and mode writes are refused.

Available options:

running,

paused,

draining,

switchingModes

Example:

"running"

mode

enum<string>

required

The engine a queue runs. queue tests entries in strict arrival order, one line. graph builds a dependency graph and may test entries speculatively in parallel, which merges faster but can require bisection to attribute a failure. Changing mode is a real conversion, not a flag flip — see mergeQueues.switchModes.

Available options:

queue,

graph

Example:

"queue"

managedState

enum<string>

required

Who owns the queue's configuration. terraform — the last write came from Terraform, identified on any queue write (create, config, pause/resume/drain, mode switch) by a User-Agent or X-Source header containing terraform or opentofu, case-insensitively — the same rule as v1. terraformWithDrift — Terraform owned it and a later write was not identified as Terraform's, so the live configuration may differ from the plan. Any such write counts, including pause/resume from other automation. manual — never written by Terraform.

Available options:

manual,

terraform,

terraformWithDrift

createdAt

string<date-time>

required

When the queue was created.

Example:

"2026-07-24T20:26:04.000Z"

updatedAt

string<date-time>

required

When the queue's own record last changed — its state or configuration. Not affected by entries moving through it.

Example:

"2026-07-28T11:02:31.000Z"

repositoryUrl

string

required

Absolute browsable URL of the repository at its provider (not a Trunk API URL).

Example:

"https://github.com/acme/widgets"

pullRequestsUrl

string

required

Path — not an absolute URL — of this queue's pull-request collection on the Trunk API. Resolve it against the server URL; do not fetch it as-is.

Example:

"/v2/merge-queues/xK9mP2nQ/pull-requests"

config

object

required

A queue's full configuration. requiredStatuses (what must pass) is a merge-protection control rather than a tuning knob, so treat write access to this object as security-relevant.

Show child attributes

htmlUrl

string

The queue's page in the Trunk web app. Absent when the repository has no keyed organization (no slug to address it by).

Example:

"https://app.trunk.io/acme/merge-queue/xK9mP2nQ"