GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation retrieves merge requests for a specified GitLab group using the GitLab API v4. It allows users to filter and query merge requests based on various criteria such as author, assignee, reviewer, labels, milestone, state, creation and update times, and more. This is useful for project managers, developers, and DevOps teams to monitor and manage merge requests within a group efficiently.

Use Case Examples

  1. Fetch all merge requests for a group to review pending code changes.
  2. Filter merge requests by author or assignee to track individual contributions.
  3. Retrieve merge requests created or updated within a specific time frame for reporting.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the API request.
Authentication Type of authentication used, default is GitLab API key.
baseUrl Base URL of the GitLab instance, default is https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Parameter Schema Defines the path and query parameters for filtering merge requests, including group ID, author, assignee, reviewer, labels, milestone, state, sorting, pagination, and other filters.
Query Parameters Collection of optional query parameters to filter and customize the merge requests returned, such as author_id, assignee_username, labels, state, order_by, page, per_page, and more.
Path Parameters Path parameter specifying the group ID or URL-encoded path to identify the group whose merge requests are to be retrieved.

Output

JSON

  • id - Unique identifier of the merge request.
  • iid - Internal ID of the merge request within the group.
  • title - Title of the merge request.
  • description - Description of the merge request.
  • state - Current state of the merge request (e.g., opened, closed, merged).
  • created_at - Timestamp when the merge request was created.
  • updated_at - Timestamp when the merge request was last updated.
  • author
    • id - ID of the user who created the merge request.
  • assignee
    • id - ID of the user assigned to the merge request.
  • labels - List of labels associated with the merge request.
  • milestone
    • title - Title of the milestone associated with the merge request.
  • merge_status - Current merge status of the merge request.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the group ID or URL-encoded path is correct to avoid 404 errors.
  • Verify that the API key has sufficient permissions to access group merge requests.
  • Check that query parameters are correctly formatted and valid according to GitLab API documentation.
  • If authentication is skipped, ensure the GitLab instance allows unauthenticated access to the requested data.

Links

Discussion