GitLab API

GitlabTool

Actions1095

Merge_requests → getApiV4GroupsIdMergeRequests

AI-generated

Summary

Retrieve merge requests for a specified GitLab group by its ID or URL-encoded path, supporting extensive filtering and sorting via query parameters.

Inputs

  • id (required) — The ID or URL-encoded path of the group owned by the authenticated user to list merge requests from.
  • author_id — Filter to merge requests created by a specific user ID.
  • author_username — Filter to merge requests created by a specific username.
  • assignee_id — Filter to merge requests assigned to a specific user ID or 'None'/'Any' for unassigned/any assignee.
  • assignee_username — Filter to merge requests assigned to given usernames.
  • reviewer_username — Filter by a reviewer username, supporting 'None' or 'Any'.
  • labels — Filter by one or more labels (comma-separated). Use 'None' or 'Any' for no labels or any label.
  • milestone — Filter by a specific milestone, or use 'None'/'Any'.
  • my_reaction_emoji — Filter by merge requests reacted to by the authenticated user with the specified emoji.
  • reviewer_id — Filter by reviewer user ID, or 'None'/'Any'.
  • state — Filter by the state of merge requests: 'opened', 'closed', 'locked', 'merged', or 'all' (default).
  • order_by — Order merge requests by a specific field, e.g. 'created_at' (default).
  • sort — Sort results in 'asc' or 'desc' order (default 'desc').
  • with_labels_details — If true, include detailed label info such as color and description.
  • with_merge_status_recheck — If true, request asynchronous recalculation of merge status.
  • created_after — Filter merge requests created on or after the given ISO 8601 timestamp.
  • created_before — Filter merge requests created on or before the given ISO 8601 timestamp.
  • updated_after — Filter merge requests updated on or after the given ISO 8601 timestamp.
  • updated_before — Filter merge requests updated on or before the given ISO 8601 timestamp.
  • view — If set to 'simple', returns a simplified set of merge request fields.
  • scope — Filter merge requests by scope: 'created_by_me', 'assigned_to_me', or 'all'.
  • source_branch — Filter merge requests with a specific source branch.
  • source_project_id — Filter merge requests originating from a specific source project ID.
  • target_branch — Filter merge requests targeting a specific branch.
  • search — Search merge requests by title and description.
  • in — Scope of the search attribute: 'title', 'description', or both (comma-separated).
  • wip — Filter by draft status: 'yes' for drafts, 'no' for non-drafts.
  • page — Pagination: current page number (default 1).
  • per_page — Pagination: number of items per page (default 20).
  • non_archived — If true (default), returns merge requests from non-archived projects only.

Output shape

a list of merge request objects with fields depending on selected filters and 'view' parameter

Supports extensive filtering and pagination; results reflect GitLab API v4's response structure for group merge requests. If 'with_labels_details' is true, labels include detailed metadata. Results may be paginated and require handling accordingly.

Links

Discussion