GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation deletes a specific tag from a GitLab project's repository using the GitLab API. It is useful for managing repository tags programmatically, such as cleaning up old or unused tags in a CI/CD pipeline or automation workflow.

Use Case Examples

  1. Deleting a tag named 'v1.0' from a project with ID '12345' to remove outdated release tags.
  2. Automating tag cleanup in a GitLab repository after a deployment process.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for public endpoints or testing.
Authentication Type of authentication used for the request, default is GitLab API key.
baseUrl Base URL of the GitLab instance, default is https://gitlab.com.
Method HTTP method for the request, default is DELETE 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 GitLab API.
  • message - Additional message or error details from the API response.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the project ID and tag name are correctly URL-encoded and exist in the GitLab repository.
  • Authentication errors may occur if the API key is missing, invalid, or lacks sufficient permissions to delete tags.
  • HTTP 404 errors indicate the project or tag was not found; verify the identifiers.
  • HTTP 403 errors indicate insufficient permissions; check the API key's access rights.

Links

Discussion