GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation retrieves details about a specific protected tag in a GitLab project using the GitLab API. It is useful for scenarios where you need to check the protection status or metadata of a particular tag within a project, such as verifying release tags or managing access controls on tags.

Use Case Examples

  1. Get details of a protected tag named 'release*' in a project with a specific ID to verify its protection settings.
  2. Fetch information about a wildcard protected tag to manage tag permissions programmatically.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the API request.
Authentication Type of authentication used for the API request, hidden unless Skip Authentication is false.
baseUrl Base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Path Parameters Parameters for the API path, including project ID and tag name.

Output

JSON

  • id - The ID of the protected tag.
  • name - The name of the protected tag.
  • create_access_levels - Access levels that can create the tag.
  • update_access_levels - Access levels that can update the tag.
  • unprotect_access_levels - Access levels that can unprotect the tag.

Dependencies

  • GitLab API authentication

Troubleshooting

  • Ensure the project ID and tag name are correctly URL-encoded to avoid 404 errors.
  • Check that the authentication credentials are valid and have sufficient permissions to access the protected tag information.
  • If skipping authentication, verify that the GitLab instance allows unauthenticated access to this endpoint.

Links

Discussion