GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation deletes a specific token associated with a cluster agent in a GitLab project. It is useful for managing and revoking access tokens for cluster agents, ensuring security and control over agent permissions. For example, if a token is compromised or no longer needed, this operation can be used to remove it.

Use Case Examples

  1. Deleting a compromised cluster agent token to prevent unauthorized access.
  2. Removing an unused token to maintain a clean and secure project environment.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
Authentication Type of authentication used, defaulting to GitLab API key.
baseUrl The 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, agent, and token to delete.

Output

JSON

  • statusCode - HTTP status code of the delete operation response.
  • body - Response body, typically empty for a successful delete operation.

Dependencies

  • Requires GitLab API key credential for authentication unless skipping authentication is enabled.

Troubleshooting

  • Ensure the provided project ID, agent ID, and token ID are correct and exist in GitLab.
  • Authentication errors may occur if the API key is missing or invalid; verify credentials.
  • Permission errors may occur if the API key does not have sufficient rights to delete cluster agent tokens.

Links

Discussion