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 token against gitlab.com, which is the only host this endpoint talks to: to use it against a self-managed instance, run the server yourself — its documentation covers that. 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. That is why the figures differ elsewhere: the upstream project catalogues 1,006 actions across 162 domains, and 851 on the Free/CE surface, while this deployment publishes 747 because it is OAuth-only and acts with your token, so the administration domains a non-admin account cannot call never appear. All three describe the same catalog, counted from three vantage points.

Back to the server card

1. merge_request.approval_config

   MR Approval Configread-only

   Get the approvals of a merge request. Returns: whether it is approved, the approved-by users with timestamps, and whether the calling user has approved and may approve. For approvals required and left, use the approval state. See also: merge_request.approve.

   Required parameters: merge_request_iid (integer), project_id (string)

2. merge_request.approval_reset

   MR 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)

3. merge_request.approve

   MR 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)

4. merge_request.cancel_auto_merge

   MR 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)

5. merge_request.commits

   MR 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)

6. merge_request.context_commits_create

   Create 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)

7. merge_request.context_commits_delete

   Delete 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)

8. merge_request.context_commits_list

   List 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)

9. merge_request.create

   MR 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)

10. merge_request.create_pipeline

    MR 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)

11. merge_request.create_todo

    MR 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)

12. merge_request.delete

    MR 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)

13. merge_request.emoji_mr_create

    MR 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)

14. merge_request.emoji_mr_delete

    MR 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)

15. merge_request.emoji_mr_get

    MR 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)

16. merge_request.emoji_mr_list

    MR 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)

17. merge_request.emoji_mr_note_create

    MR 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)

18. merge_request.emoji_mr_note_delete

    MR 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)

19. merge_request.emoji_mr_note_get

    MR 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)

20. merge_request.emoji_mr_note_list

    MR 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)

21. merge_request.event_mr_label_get

    MR 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)

22. merge_request.event_mr_label_list

    MR 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)

23. merge_request.event_mr_milestone_get

    MR 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)

24. merge_request.event_mr_milestone_list

    MR 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)

25. merge_request.event_mr_state_get

    MR 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)

26. merge_request.event_mr_state_list

    MR 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)

27. merge_request.get

    MR 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)

28. merge_request.issues_closed

    MR 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)

29. merge_request.list

    MR 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)

30. merge_request.list_global

    MR 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

31. merge_request.list_group

    MR 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)

32. merge_request.merge

    MR 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)

33. merge_request.participants

    MR 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)

34. merge_request.pipelines

    MR 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)

35. merge_request.rebase

    MR 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)

36. merge_request.related_issues

    MR 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)

37. merge_request.reviewers

    MR 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)

38. merge_request.spent_time_add

    MR 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)

39. merge_request.spent_time_reset

    MR 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)

40. merge_request.subscribe

    MR 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)

41. merge_request.time_estimate_reset

    MR 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)

42. merge_request.time_estimate_set

    MR 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)

43. merge_request.time_stats

    MR 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)

44. merge_request.unapprove

    MR 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)

45. merge_request.unsubscribe

    MR 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)

46. merge_request.update

    MR 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)