v2

latestOpenAPI 3.1.0UNLICENSED2026-07-26210239.8 KB

Get the merge queue.

post/getQueue

Request body

targetBranchstring required

Response

OK

state'running' | 'paused' | 'draining' | 'switching_modes' required

The state of the merge queue. See https://docs.trunk.io/merge-queue/administration/advanced-settings#merge-queue-state for the full description of each state.

branchstring required
concurrencynumber required
testingTimeoutMinutesnumber required
mode'single' | 'parallel' required
canOptimisticallyMergeboolean required
pendingFailureDepthnumber required
batchboolean required
batchingMaxWaitTimeMinutesnumber required
batchingMinSizenumber required
createPrsForTestingBranchesboolean required
commentsEnabledboolean required
commandsEnabledboolean required
statusCheckEnabledboolean required
bisectionConcurrencynumber required
requiredStatusesstring[] required
directMergeMode'off' | 'always' required

Controls whether PRs can skip the queue's test run and merge directly when already up to date with the target branch. See https://docs.trunk.io/merge-queue/administration/advanced-settings#direct-merge-to-main for details.

optimizationMode'off' | 'bisection_skip_redundant_tests' required

The optimization strategy for the merge queue. off — no optimizations. See https://docs.trunk.io/merge-queue/optimizations/batching#test-caching-during-bisection for details on bisection_skip_redundant_tests.

mergeMethod'merge_commit' | 'squash' | 'rebase' required

The Git strategy used to merge a PR into the target branch. See https://docs.trunk.io/merge-queue/administration/advanced-settings#merge-method for details.