GitLab API

GitlabTool
Join our community

Actions905

Overview

This node operation deletes a specific tag from a GitLab project's repository. It is useful for managing and cleaning up tags in a GitLab project, such as removing outdated or incorrect tags. For example, a user can automate the deletion of tags that are no longer needed after a release cycle.

Use Case Examples

  1. Deleting a tag named 'v1.0' from a project with ID '12345' to clean up old release tags.
  2. Automating tag removal in a CI/CD pipeline after a deployment.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
Authentication Type of authentication used, default is GitLab API key.
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 tag to delete.

Output

JSON

  • success - Indicates if the tag deletion was successful.
  • statusCode - HTTP status code returned by the API.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the project ID and tag name are correctly specified and URL-encoded if necessary.
  • Check that the API key has sufficient permissions to delete tags in the project.
  • Common error: 404 Not Found - The project or tag does not exist or the user lacks access.
  • Common error: 401 Unauthorized - Authentication failed or API key is invalid.

Links

Discussion