GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation retrieves a list of projects shared with a specific GitLab group. It is useful for scenarios where you need to manage or analyze projects associated with a group, such as auditing shared projects, filtering projects by various criteria, or integrating project data into workflows.

Use Case Examples

  1. Fetch all projects shared with a group by its ID.
  2. Filter shared projects by visibility or archived status.
  3. Retrieve projects with specific features enabled, like issues or merge requests.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
Authentication Type of authentication used, defaulting to 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.
Query Parameters Optional filters and pagination parameters for the request, such as archived status, visibility, search term, ordering, pagination, and feature flags.
Path Parameters Path parameter specifying the group ID to retrieve shared projects for.

Output

JSON

  • id - Project ID.
  • name - Project name.
  • path - Project path.
  • visibility - Project visibility status.
  • archived - Whether the project is archived.
  • starred - Whether the project is starred by the user.
  • issues_enabled - Whether issues are enabled for the project.
  • merge_requests_enabled - Whether merge requests are enabled for the project.
  • access_level - Access level of the authenticated user on the project.
  • custom_attributes - Custom attributes included if requested.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the group ID path parameter is correctly set and valid.
  • Verify that the authentication token has sufficient permissions to access group projects.
  • Check that optional query parameters are correctly formatted and valid according to GitLab API specifications.
  • Common error messages may include 401 Unauthorized (authentication issues), 404 Not Found (invalid group ID), and 400 Bad Request (invalid query parameters). Resolving these involves verifying credentials, group ID, and parameter formats.

Links

Discussion