GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation deletes a protected tag from a specified project in GitLab using the GitLab API. It is useful for managing project tags by removing tags that are no longer needed or should no longer be protected, such as outdated release tags or tags created by mistake.

Use Case Examples

  1. Deleting a protected tag named 'release-1-0' from a project with ID '12345' to allow normal tag operations on that tag.
  2. Removing a protected tag to update project versioning or release management workflows.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for public or unauthenticated API endpoints.
Authentication Type of authentication used, default is GitLab API key authentication.
baseUrl Base URL of the GitLab instance, default is https://gitlab.com.
Method HTTP method to use for the request, default is GET but DELETE is used for this operation.
Path Parameters Parameters required in the URL path to identify the project and the protected tag to delete.

Output

JSON

  • success - Indicates whether the protected tag was successfully deleted.
  • statusCode - HTTP status code returned by the API, e.g., 204 for successful deletion.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the project ID and protected tag name are correct and URL-encoded if necessary.
  • Check that the API key has sufficient permissions to delete protected tags in the project.
  • If authentication is skipped, verify that the GitLab instance allows unauthenticated access for this operation.
  • Common error: 404 Not Found - The project or protected tag does not exist or the user lacks access.
  • Common error: 403 Forbidden - The API key does not have permission to delete protected tags.

Links

Discussion