GitLab API

GitlabTool
Join our community

Actions1000

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. For example, a user can delete a protected tag named 'release-1-0' from a project identified by its ID or URL-encoded path.

Use Case Examples

  1. Deleting a protected tag 'release-1-0' from a project with ID '12345' to allow changes to that tag.
  2. Removing outdated or incorrect protected tags from a GitLab project to maintain tag hygiene.

Properties

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

Output

JSON

  • statusCode - HTTP status code returned by the API indicating the result of the delete operation.
  • responseBody - The body of the response from the API, typically empty or containing confirmation of deletion.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the project ID and protected tag name are correctly specified and URL-encoded if necessary.
  • Authentication errors may occur if the API key is missing or invalid; verify credentials.
  • HTTP 404 errors indicate the project or protected tag was not found; check the identifiers.
  • HTTP 403 errors indicate insufficient permissions to delete the protected tag; verify user access rights.

Links

Discussion