git.merge-queue.getShow a branch queue: settings, entries in order, recent results and events
Request syntax
GET /git/api/repositories/{repoId}/merge-queuePath parameters
repoIdRequiredstring
Constraints: uuid
Query parameters
branchRequiredstring
The target branch whose queue to show
Constraints: 1-255 chars
Response
200 with `branch`, `required` (whether a rule requires a queue), `config`, `entries` (live entries with state and `position`, null while waiting), `finished` (the last 20) and `events` (the last 100).
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
branchAlwaysstring
The branch whose queue this isrequiredAlwaysboolean
A protection rule requires a merge queue on itconfigAlwaysobject, may be null
The queue settings; null when noneconfig.ruleIdAlwaysstring
The branch protection rule that requires the queueconfig.methodAlwaysone of merge, squash, rebase
How queued pull requests are mergedconfig.buildConcurrencyAlwaysnumber
Builds that may run at onceconfig.minGroupSizeAlwaysnumber
Fewest pull requests merged togetherconfig.maxGroupSizeAlwaysnumber
Most pull requests merged togetherconfig.waitMinutesAlwaysnumber
Minutes to wait for the minimum group to fillconfig.checkTimeoutMinutesAlwaysnumber
Minutes a build may take before it counts as failedconfig.onlyNonFailingAlwaysboolean
A failed build removes its pull request at once, rather than waiting on later buildsentriesAlwaysarray of object
The entries still in the queue, in orderentries[].idAlwaysstring
The queue entry identries[].orgIdAlwaysstring
The organization that owns itentries[].repoIdAlwaysstring
The repositoryentries[].prIdAlwaysstring
The pull request queuedentries[].baseBranchAlwaysstring
The protected branch the queue merges intoentries[].stateAlwaysone of waiting, queued, building, passed, failed, merged, removed
waiting (for approvals and checks), queued, building, passed, failed, merged or removedentries[].positionAlwaysnumber, may be null
1-based place in line; null while waitingentries[].headOidAlwaysstring, may be null
Pull request head when it joined the line; null while waitingentries[].baseOidAlwaysstring, may be null
The commit its build sits on; null until builtentries[].groupOidAlwaysstring, may be null
The commit built: the base, every entry ahead, and this one; null until builtentries[].tempRefAlwaysstring, may be null
The temporary branch built; null until builtentries[].mergeMethodAlwaysone of merge, squash, rebase, may be null
How it will be mergedentries[].enqueuedByIamUserIdAlwaysstring, may be null
Who added it; null when that IAM user is goneentries[].removalReasonAlwaysstring, may be null
Why it left the queue; null unless removedentries[].queuedAtAlwaysstring, may be null
When it joined the line; null while waitingentries[].buildStartedAtAlwaysstring, may be null
When its build started; null until thenentries[].finishedAtAlwaysstring, may be null
When it merged or left; null while in the queueentries[].createdAtAlwaysstring
When it was addedentries[].updatedAtAlwaysstring
When it last changedentries[].prAlwaysobject
The pull request of the entryentries[].pr.numberAlwaysnumber
The pull request numberentries[].pr.titleAlwaysstring
Its titleentries[].pr.sourceBranchAlwaysstring
Its source branchentries[].pr.stateAlwaysone of open, closed, merged, draft
Its stateentries[].pr.authorIamUserIdAlwaysstring
Who opened itentries[].pr.sourceOidAlwaysstring, may be null
Its head commit, as last recordedfinishedAlwaysarray of object
The last 20 entries that merged or left, newest firstfinished[].idAlwaysstring
The queue entry idfinished[].orgIdAlwaysstring
The organization that owns itfinished[].repoIdAlwaysstring
The repositoryfinished[].prIdAlwaysstring
The pull request queuedfinished[].baseBranchAlwaysstring
The protected branch the queue merges intofinished[].stateAlwaysone of waiting, queued, building, passed, failed, merged, removed
waiting (for approvals and checks), queued, building, passed, failed, merged or removedfinished[].positionAlwaysnumber
Sort key in the queue: a larger one is further backfinished[].headOidAlwaysstring, may be null
Pull request head when it joined the line; null while waitingfinished[].baseOidAlwaysstring, may be null
The commit its build sits on; null until builtfinished[].groupOidAlwaysstring, may be null
The commit built: the base, every entry ahead, and this one; null until builtfinished[].tempRefAlwaysstring, may be null
The temporary branch built; null until builtfinished[].mergeMethodAlwaysone of merge, squash, rebase, may be null
How it will be mergedfinished[].enqueuedByIamUserIdAlwaysstring, may be null
Who added it; null when that IAM user is gonefinished[].removalReasonAlwaysstring, may be null
Why it left the queue; null unless removedfinished[].queuedAtAlwaysstring, may be null
When it joined the line; null while waitingfinished[].buildStartedAtAlwaysstring, may be null
When its build started; null until thenfinished[].finishedAtAlwaysstring, may be null
When it merged or left; null while in the queuefinished[].createdAtAlwaysstring
When it was addedfinished[].updatedAtAlwaysstring
When it last changedfinished[].prAlwaysobject
The pull request of the entryfinished[].pr.numberAlwaysnumber
The pull request numberfinished[].pr.titleAlwaysstring
Its titlefinished[].pr.sourceBranchAlwaysstring
Its source branchfinished[].pr.stateAlwaysone of open, closed, merged, draft
Its statefinished[].pr.authorIamUserIdAlwaysstring
Who opened itfinished[].pr.sourceOidAlwaysstring, may be null
Its head commit, as last recordedeventsAlwaysarray of object
The last 100 queue events, newest firstevents[].idAlwaysstring
The event idevents[].orgIdAlwaysstring
The organizationevents[].repoIdAlwaysstring
The repositoryevents[].baseBranchAlwaysstring
The queue, by its branchevents[].entryIdAlwaysstring, may be null
The queue entry concerned; null for the queue as a wholeevents[].prIdAlwaysstring, may be null
The pull request concerned; null for the queue as a wholeevents[].kindAlwaysone of waiting, queued, build_started, checks_passed, checks_failed, conflict, rebuild, merged, removed
What happenedevents[].detailAlwaysstring, may be null
A sentence on what happened and whyevents[].actorIamUserIdAlwaysstring, may be null
Who acted; null when the queue itself didevents[].commitOidAlwaysstring, may be null
The commit concerned, if anyevents[].createdAtAlwaysstring
When it happenedevents[].prNumberAlwaysnumber, may be null
The pull request number; null when noneevents[].actorAlwaysstring, may be null
The actor's username; null when the queue acted
Checked against the handlers: every route test validates their answers against this schema.
Errors
- 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
- 401No credentials, or an access key that is unknown, revoked or expired.
- 403The caller's policies do not allow git:GetMergeQueue on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
- 404The resource does not exist in your organization.
Examples
The required parameters only, with example values. Replace id and the other placeholders with your own.
dcloud git merge-queue get repoId --branch examplecurl -X GET "https://console.platform-development.deutschecloud.app/git/api/repositories/repoId/merge-queue" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_git_merge-queue_get.