GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation deletes a specific tag from a GitLab project repository. It is useful for managing and cleaning up tags in a project's repository, such as removing outdated or incorrect tags. For example, a user can specify the project ID and the tag name to delete that tag from the repository.

Use Case Examples

  1. Delete a tag named 'v1.0' from a project with ID '12345' to remove an outdated release tag.
  2. Remove a mistakenly created tag from a project repository by specifying the tag name and project ID.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
Authentication The authentication method used for the request, defaulting to GitLab API key.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method The HTTP method to use for the request, defaulting to GET but can be set to DELETE for this operation.
Path Parameters Parameters required in the request path to identify the project and tag to delete.

Output

JSON

  • statusCode - HTTP status code of the delete operation response.
  • responseBody - The response body returned from the GitLab API after attempting to delete the tag.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the project ID and tag name are correctly specified; otherwise, the API will return an error indicating the tag or project was not found.
  • If authentication is skipped or invalid, the API will return an authentication error; ensure valid credentials are provided unless skipping authentication is intentional.
  • Check the base URL if using a self-hosted GitLab instance to ensure the request targets the correct server.

Links

Discussion