GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation retrieves the list of protected tags for a specific project in GitLab using the GitLab API v4. It is useful for scenarios where you need to manage or audit protected tags within a project, such as in CI/CD pipelines or project management automation. For example, you can use this node to fetch protected tags to ensure certain branches or tags are safeguarded from unauthorized changes.

Use Case Examples

  1. Fetch protected tags of a project to display in a dashboard.
  2. Automate the verification of protected tags before deployment.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for public or unauthenticated access scenarios.
Authentication Select the authentication method, defaulting to GitLab API key authentication.
baseUrl Base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Query Parameters Optional query parameters for pagination, including page number and items per page.
Path Parameters Path parameters specifying the project ID or URL-encoded path to identify the project.

Output

JSON

  • id - The unique identifier of the protected tag.
  • name - The name of the protected tag.
  • create_access_levels - Access levels that are allowed to create the protected tag.
  • update_access_levels - Access levels that are allowed to update the protected tag.
  • delete_access_levels - Access levels that are allowed to delete the protected tag.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the project ID or URL-encoded path is correct to avoid 404 errors.
  • Verify that the GitLab API key credential has sufficient permissions to access project protected tags.
  • Check network connectivity and base URL correctness if requests fail to reach the GitLab instance.

Links

Discussion