GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation deletes a specific deploy token from a GitLab group. It is useful for managing access tokens that allow deployment automation, ensuring that tokens no longer needed or compromised can be removed to maintain security. For example, a DevOps engineer might use this node to revoke a deploy token after a project is completed or when rotating credentials.

Use Case Examples

  1. Deleting a deploy token from a GitLab group to revoke deployment access.
  2. Automating the cleanup of deploy tokens in CI/CD pipelines.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for testing or public endpoints.
Authentication The authentication method used for the request, typically an API key credential for GitLab.
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 used for this operation.
Path Parameters Parameters required in the URL path to identify the group and the deploy token to delete.

Output

JSON

  • success - Indicates whether the deploy token was successfully deleted.

Dependencies

  • GitLab API authentication token

Troubleshooting

  • Ensure the provided group ID and deploy token ID are correct and exist in the GitLab instance.
  • Verify that the API authentication token has sufficient permissions to delete deploy tokens in the specified group.
  • Check the base URL to ensure it points to the correct GitLab instance, especially if using a self-hosted GitLab server.
  • Common error messages include 404 Not Found if the group or token does not exist, and 403 Forbidden if the authentication token lacks necessary permissions.

Links

Discussion