Action domain

`merge_request`

Every action this domain exposes through gitlab_execute_action, from the gitlab://tools manifest. Each entry folds out to its full upstream description and required parameters.

46 · actions7 · destructive23 · read-only

Counted with a Free-tier GitLab token. The catalog is scoped to the token that asks, so the count moves with both its tier and its permissions: higher tiers expose more actions, and administration domains only appear to tokens allowed to use them.

Back to the server card

merge_request.approval_configMR Approval Configread-only
Get the approval configuration of a merge request. Returns: approvals required and left, approved-by users with timestamps, suggested approvers, approver groups, and the remaining approval rules. See also: merge_request.approve.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.approval_resetMR Approval Resetdestructive
Reset all approvals on a merge request. Returns: a success confirmation. See also: merge_request.approval_config, merge_request.unapprove.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.approveMR Approve
Approve a merge request on behalf of the caller. Returns: the approval state with required-approvals count, approved-by count, and overall approved flag. See also: merge_request.unapprove, merge_request.merge, merge_request.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.cancel_auto_mergeMR Cancel Auto Merge
Cancel auto-merge (merge-when-pipeline-succeeds) on a merge request. Returns: the MR with auto-merge disabled. See also: merge_request.merge, merge_request.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.commitsMR Commitsread-only
List the commits that make up a merge request. Returns: commit SHAs, titles, authors, and timestamps with pagination metadata. See also: merge_request.get, repository.commit_get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.context_commits_createCreate MR Context Commits
Attach existing repository commit SHAs to a merge request as context commits. Returns: the resulting context commit summaries (full SHA, short SHA, title, author name/email, created date). See also: merge_request.context_commits_list, merge_request.context_commits_delete, repository.commit_get.
Required parameters: commits (array), merge_request_iid (integer), project_id (string)
merge_request.context_commits_deleteDelete MR Context Commitsdestructive
Remove context commits from a merge request by SHA, detaching them from the review. Returns: a success confirmation. The underlying repository commits are left intact. See also: merge_request.context_commits_list, merge_request.context_commits_create, merge_request.get.
Required parameters: commits (array), merge_request_iid (integer), project_id (string)
merge_request.context_commits_listList MR Context Commitsread-only
List the context commits pinned to a merge request for review. Returns: commit summaries (full SHA, short SHA, title, author name/email, created date). See also: merge_request.get, merge_request.context_commits_create, merge_request.context_commits_delete.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.createMR Create
Open a new merge request from a source branch into a target branch. Returns: the created MR with IID, state, source/target branches, merge status, assignees, reviewers, labels, and web URL. See also: merge_request.get, merge_request.list, merge_request.merge.
Required parameters: project_id (string), source_branch (string), target_branch (string), title (string)
merge_request.create_pipelineMR Create Pipeline
Trigger a new CI/CD pipeline for a merge request. Returns: the created pipeline with id, status, ref, sha, and web URL. See also: merge_request.pipelines, pipeline.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.create_todoMR Create Todo
Create a to-do for a merge request for the caller. Returns: the created to-do item with action, target, and state. See also: merge_request.get, merge_request.subscribe.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.deleteMR Deletedestructive
Delete a merge request permanently. Returns: a success confirmation naming the MR and project. See also: merge_request.update, merge_request.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.emoji_mr_createMR Emoji Create
Add an emoji reaction to a merge request. Returns: the created award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: merge_request.emoji_mr_list, merge_request.emoji_mr_delete.
Required parameters: merge_request_iid (integer), name (string), project_id (string)
merge_request.emoji_mr_deleteMR Emoji Deletedestructive
Remove an emoji reaction from a merge request by award id. Returns: a success confirmation naming the award emoji. See also: merge_request.emoji_mr_list, merge_request.emoji_mr_get.
Required parameters: award_id (integer), merge_request_iid (integer), project_id (string)
merge_request.emoji_mr_getMR Emoji Getread-only
Get a single emoji reaction on a merge request by award id. Returns: the award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: merge_request.emoji_mr_list, merge_request.emoji_mr_delete.
Required parameters: award_id (integer), merge_request_iid (integer), project_id (string)
merge_request.emoji_mr_listMR Emoji Listread-only
List all emoji reactions on a merge request. Returns: each award with its emoji name, the awarding user object, awardable id/type, and pagination metadata. See also: merge_request.emoji_mr_get, merge_request.emoji_mr_create, merge_request.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.emoji_mr_note_createMR Note Emoji Create
Add an emoji reaction to a merge request note. Returns: the created award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: merge_request.emoji_mr_note_list, merge_request.emoji_mr_note_delete.
Required parameters: merge_request_iid (integer), name (string), note_id (integer), project_id (string)
merge_request.emoji_mr_note_deleteMR Note Emoji Deletedestructive
Remove an emoji reaction from a merge request note by award id. Returns: a success confirmation naming the award emoji. See also: merge_request.emoji_mr_note_list, merge_request.emoji_mr_note_get.
Required parameters: award_id (integer), merge_request_iid (integer), note_id (integer), project_id (string)
merge_request.emoji_mr_note_getMR Note Emoji Getread-only
Get a single emoji reaction on a merge request note by award id. Returns: the award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: merge_request.emoji_mr_note_list, merge_request.emoji_mr_note_delete.
Required parameters: award_id (integer), merge_request_iid (integer), note_id (integer), project_id (string)
merge_request.emoji_mr_note_listMR Note Emoji Listread-only
List all emoji reactions on a merge request note (comment). Returns: each award with its emoji name, the awarding user object, awardable id/type, and pagination metadata. See also: merge_request.emoji_mr_note_get, merge_request.emoji_mr_note_create, mr_review.note_get.
Required parameters: merge_request_iid (integer), note_id (integer), project_id (string)
merge_request.event_mr_label_getMR Label Event Getread-only
Get a single label event for a merge request. Returns: the event with action, the label object, and the acting user. See also: merge_request.event_mr_label_list.
Required parameters: label_event_id (integer), merge_request_iid (integer), project_id (string)
merge_request.event_mr_label_listMR Label Event Listread-only
List label events for a merge request. Returns: label events with action, the label object, the acting user, and pagination metadata. See also: merge_request.event_mr_label_get, merge_request.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.event_mr_milestone_getMR Milestone Event Getread-only
Get a single milestone event for a merge request. Returns: the event with action, the milestone object, and the acting user. See also: merge_request.event_mr_milestone_list.
Required parameters: merge_request_iid (integer), milestone_event_id (integer), project_id (string)
merge_request.event_mr_milestone_listMR Milestone Event Listread-only
List milestone events for a merge request. Returns: milestone events with action, the milestone object, the acting user, and pagination metadata. See also: merge_request.event_mr_milestone_get, merge_request.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.event_mr_state_getMR State Event Getread-only
Get a single state event for a merge request. Returns: the event with the state value and the acting user. See also: merge_request.event_mr_state_list.
Required parameters: merge_request_iid (integer), project_id (string), state_event_id (integer)
merge_request.event_mr_state_listMR State Event Listread-only
List state events for a merge request. Returns: state events with the state value, the acting user, and pagination metadata. See also: merge_request.event_mr_state_get, merge_request.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.getMR Getread-only
Get a single merge request from a project by its IID. Returns: MR metadata, state, source/target branches, merge status, assignees, reviewers, labels, milestone, and web URL. See also: merge_request.list, merge_request.update, merge_request.merge, merge_request.commits.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.issues_closedMR Issues Closedread-only
List issues that will be closed when the merge request is merged. Returns: issues with state, labels, assignees, and web URL plus pagination metadata. See also: merge_request.related_issues, issue.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.listMR Listread-only
List merge requests in one project with filtering and pagination. Returns: matching MRs with state, branches, merge status, assignees, reviewers, labels, and pagination metadata. See also: merge_request.get, merge_request.create, merge_request.list_group.
Required parameters: project_id (string)
merge_request.list_globalMR List Globalread-only
List merge requests across all accessible projects. Returns: visible MRs with project context, state, branches, and pagination metadata. See also: merge_request.list, merge_request.list_group, search.merge_requests.
Required parameters: No required parameters
merge_request.list_groupMR List Groupread-only
List merge requests across a group and its projects. Returns: visible MRs with project context, state, branches, and pagination metadata. See also: merge_request.list, merge_request.list_global, group.get.
Required parameters: group_id (string)
merge_request.mergeMR Mergedestructive
Merge a merge request now, or schedule auto-merge when its pipeline succeeds. Returns: the merged MR with merge_commit_sha and updated state. See also: merge_request.get, merge_request.pipelines, merge_request.cancel_auto_merge.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.participantsMR Participantsread-only
List the participants of a merge request. Returns: participating users with username, name, and state. See also: merge_request.reviewers, merge_request.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.pipelinesMR Pipelinesread-only
List the CI/CD pipelines attached to a merge request. Returns: pipelines with id, status, ref, sha, and web URL. See also: merge_request.create_pipeline, merge_request.merge, pipeline.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.rebaseMR Rebase
Rebase a merge request's source branch onto its target. Returns: whether a rebase is now in progress (poll merge_request.get to track completion). See also: merge_request.get, merge_request.merge.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.related_issuesMR Related Issuesread-only
List issues related to a merge request. Returns: issues with state, labels, assignees, and web URL plus pagination metadata. See also: merge_request.issues_closed, issue.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.reviewersMR Reviewersread-only
List the reviewers of a merge request. Returns: reviewer users with username, name, and review state. See also: merge_request.participants, merge_request.update.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.spent_time_addMR Add Spent Time
Add spent time to a merge request. Returns: the updated time tracking stats (estimate and spent time, seconds and human-readable). See also: merge_request.spent_time_reset, merge_request.time_estimate_set, merge_request.time_stats.
Required parameters: duration (string), merge_request_iid (integer), project_id (string)
merge_request.spent_time_resetMR Reset Spent Time
Reset a merge request's spent time. Returns: the updated time tracking stats. See also: merge_request.spent_time_add, merge_request.time_stats.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.subscribeMR Subscribe
Subscribe the caller to a merge request's notifications. Returns: the MR with the updated subscription state. See also: merge_request.unsubscribe, merge_request.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.time_estimate_resetMR Reset Time Estimate
Clear a merge request's time estimate. Returns: the updated time tracking stats. See also: merge_request.time_estimate_set, merge_request.time_stats.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.time_estimate_setMR Set Time Estimate
Set a merge request's time estimate. Returns: the updated time tracking stats (estimate and spent time, seconds and human-readable). See also: merge_request.time_estimate_reset, merge_request.spent_time_add, merge_request.time_stats.
Required parameters: duration (string), merge_request_iid (integer), project_id (string)
merge_request.time_statsMR Time Statsread-only
Read a merge request's time tracking totals. Returns: estimate and spent time in seconds and human-readable form. See also: merge_request.time_estimate_set, merge_request.spent_time_add.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.unapproveMR Unapprovedestructive
Remove the caller's approval from a merge request. Returns: a success confirmation naming the MR and project. See also: merge_request.approve, merge_request.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.unsubscribeMR Unsubscribe
Unsubscribe the caller from a merge request's notifications. Returns: the MR with the updated subscription state. See also: merge_request.subscribe, merge_request.get.
Required parameters: merge_request_iid (integer), project_id (string)
merge_request.updateMR Update
Update an existing merge request's fields or state. Returns: the updated MR with its new field values, state, labels, assignees, and reviewers. See also: merge_request.get, merge_request.merge, merge_request.approve.
Required parameters: merge_request_iid (integer), project_id (string)