MergeRequest
Shape
- created_atstring
- created_byPrincipalId (string · uuid)The person or agent who opened it.
- is_draftboolean
- merge_request_idMergeRequestId (integer · int64)
- repository_idRepositoryId (string · uuid)
- source_branchBranchName (string)
- source_branch_deletedboolean
- source_branch_headCommitHash (string)
- statusMergeRequestStatusopenmergedclosed
- target_branchBranchName (string)
- target_branch_headCommitHash (string)
- titleMrTitle (string)
- updated_atstring
- author_can_pushboolean or nulloptionalWhether the author can push to the repository — false for a drive-by contributor's merge request. Absent where it was not computed.
- closed_atstring or nulloptional
- closed_byPrincipalId (string · uuid) or nulloptional
- descriptionMrDescription (string) or nulloptional
- merge_commit_shaCommitHash (string) or nulloptional
- merged_atstring or nulloptional
- merged_byPrincipalId (string · uuid) or nulloptional
- restack_requiredbooleanoptionalPrecise restack signal — set when this MR's downstack was squash-merged (a rebase is genuinely required to drop the duplicated diff). Distinct from the advisory
commits_behind. Reset on the MR's next source-advancing write. stack_summaryStackSummary or nulloptionalThe neighbouring merge requests in this stack. Returned when fetching a single merge request, not in listings.
- The StackSummary schema
- has_downstackboolean
- has_upstackboolean
- downstack_mr_idMergeRequestId (integer · int64) or nulloptional
- upstack_mr_idsarray of MergeRequestId (integer · int64)optional
- versioninteger · int64optional0–∞Optimistic-concurrency counter. Bumped on every write; writes condition on the read value.
Example
Synthesized example{
"created_at": "2026-10-13T00:23:47Z",
"created_by": "b7e2d1c0-9f8e-4d7c-a6b5-c4d3e2f1a0b9",
"is_draft": false,
"merge_request_id": 42,
"repository_id": "5b0e7c2a-9d14-4e8b-a6f1-2c3d4e5f6a70",
"source_branch": "feat/run-header-stream",
"source_branch_deleted": false,
"source_branch_head": "1ba869009e48f90df3d4557c6b144c85c38a1941",
"status": "open",
"target_branch": "main",
"target_branch_head": "fcf8f3c3f951f96d9c205e9425c43dd2b4a83f29",
"title": "Draw the region map from operation density",
"updated_at": "2026-10-14T08:48:11Z",
"author_can_push": false,
"closed_at": "2026-10-14T02:23:45Z",
"closed_by": "b7e2d1c0-9f8e-4d7c-a6b5-c4d3e2f1a0b9",
"description": "Renders each region as density contours of its operations.",
"merge_commit_sha": "53a6f17f33f9cefb3c3e481a3f6f2c0b125da2f2",
"merged_at": "2026-10-12T08:39:39Z",
"merged_by": "b7e2d1c0-9f8e-4d7c-a6b5-c4d3e2f1a0b9",
"restack_required": false,
"stack_summary": {
"has_downstack": false,
"has_upstack": false,
"downstack_mr_id": 42,
"upstack_mr_ids": [
42
]
},
"version": 50
}
Graph
Used by
Sent by 0 operations
No operation takes it as a request body.
Returned by 13 operations
- GETList the merge requests linked to a group work item/groups/{group_id}/issues/{issue_id}/merge-requests
- GETList merge requests across a group's subtree/groups/{group_id}/merge-requests
- GETList the merge requests linked to a repository work item/repositories/{repo_id}/issues/{issue_id}/merge-requests
- GETList merge requests/repositories/{repo_id}/merge-requests
- POSTCreate a merge request/repositories/{repo_id}/merge-requests
- GETGet a merge request by ID/repositories/{repo_id}/merge-requests/{mr_id}
- PUTUpdate a merge request/repositories/{repo_id}/merge-requests/{mr_id}
- POSTClose a merge request/repositories/{repo_id}/merge-requests/{mr_id}/close
- POSTResolve a merge request's conflicts/repositories/{repo_id}/merge-requests/{mr_id}/conflicts/resolve
- POSTMerge a merge request/repositories/{repo_id}/merge-requests/{mr_id}/merge
- POSTReopen a merge request/repositories/{repo_id}/merge-requests/{mr_id}/reopen
- GETList the merge requests authored by the calling user/user/merge-requests
- GETList the merge requests the calling user is a reviewer of, across all repos/user/review-requests