GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation retrieves a list of projects shared with a specific GitLab group using the GitLab API v4. It is useful for scenarios where you need to access or manage projects associated with a group, such as auditing shared projects, managing permissions, or integrating project data into workflows. For example, a user can fetch all projects shared with a group to display them in a dashboard or to automate project management tasks.

Use Case Examples

  1. Fetch all projects shared with a GitLab group by specifying the group ID.
  2. Filter shared projects by visibility or archived status to get a refined list.
  3. Paginate through shared projects using page and per_page parameters for large groups.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for public data or testing.
Authentication The authentication method used for the API request, typically an API key credential.
baseUrl The base URL of the GitLab instance to which the request is sent, defaulting to https://gitlab.com.
Method HTTP method used for the request, default is GET.
Query Parameters Optional filters and pagination parameters to refine the list of shared projects, such as archived status, visibility, search term, ordering, pagination, and feature flags.
Path Parameters The path parameter specifying the group ID for which shared projects are retrieved.

Output

JSON

  • id - The unique identifier of the shared project
  • name - The name of the shared project
  • path - The path or URL segment of the shared project
  • visibility - The visibility level of the shared project (private, internal, public)
  • archived - Indicates if the project is archived
  • starred - Indicates if the project is starred by the user
  • issues_enabled - Indicates if issues are enabled for the project
  • merge_requests_enabled - Indicates if merge requests are enabled for the project
  • access_level - The access level of the authenticated user on the project
  • custom_attributes - Custom attributes included if requested

Dependencies

  • GitLab API authentication token or API key credential

Troubleshooting

  • Ensure the group ID path parameter is correctly set and valid; an invalid or missing ID will cause errors.
  • Verify that the authentication token has sufficient permissions to access group projects; insufficient permissions may result in authorization errors.
  • Check the base URL if using a self-hosted GitLab instance to ensure it is correct and reachable.
  • If filtering parameters are used, ensure they conform to expected types and values to avoid request errors.

Links

Discussion