GitLab API

GitlabTool

Actions1095

Merge_requests → getApiV4ProjectsIdMergeRequests

AI-generated

Summary

Retrieve a list of merge requests for a specified GitLab project, filtering and sorting results using various optional query parameters.

Inputs

  • id (required) — The ID or URL-encoded path of the project for which to list merge requests.
  • queryParameters — Optional filters and sorting options for the merge requests, such as author_id, assignee_id, labels, milestone, state, created_after, updated_before, scope, wip status, and pagination parameters (page, per_page), among many others.
  • skipAuthentication — If true, skips authentication; otherwise uses configured GitLab API credentials.
  • baseUrl — Base URL of the GitLab instance; defaults to https://gitlab.com.
  • method — HTTP method to use; defaults to GET.

Output shape

a list of merge request objects matching the specified project and query filters

Supports extensive filtering, sorting, and pagination parameters as defined by the GitLab API. Returns merge requests with detailed fields unless simplified view is requested. Authentication is typically required unless skipped explicitly.

Examples

Example 1: Retrieve all open merge requests assigned to user ID 123 for project 'my-group/my-project' sorted by creation date descending.

Set 'id' path parameter to 'my-group%2Fmy-project', 'state' query parameter to 'opened', 'assignee_id' query parameter to '123', and optionally 'order_by' to 'created_at' and 'sort' to 'desc'.

Links

Discussion