GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation retrieves the share locations of a specific project in GitLab using the GitLab API v4. It is useful for users who want to find out which groups a project is shared with, optionally filtering the results by a search string. For example, a user can get a list of groups that have access to a project by providing the project ID and an optional search term to narrow down the groups.

Use Case Examples

  1. Retrieve share locations for project ID 12345 to see which groups have access.
  2. Search for groups containing 'dev' that the project ID 67890 is shared with.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the request.
Authentication The authentication method used for the request, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method The HTTP method to use for the request, defaulting to GET.
Query Parameters Optional query parameters for the request, including 'search' to filter groups by name.
Path Parameters Path parameters for the request, including 'id' which is the project ID to retrieve share locations for.

Output

JSON

  • id - The ID of the project.
  • share_locations - List of groups the project is shared with, optionally filtered by search criteria.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the project ID provided in the path parameters is valid and exists in the GitLab instance.
  • If authentication is enabled, verify that the GitLab API key credential is correctly configured and has sufficient permissions.
  • Check the baseUrl if using a self-hosted GitLab instance to ensure it is correct.
  • If the search query parameter is used, ensure it is a valid string to avoid empty or unexpected results.

Links

Discussion