GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation deletes a specific cluster agent from a GitLab project using the GitLab API. It is useful for managing and cleaning up cluster agents associated with projects, especially when an agent is no longer needed or should be removed for security or organizational reasons. For example, a DevOps engineer might use this node to automate the removal of outdated cluster agents from multiple projects.

Use Case Examples

  1. Delete a cluster agent with ID 123 from project with ID 'my-project' to revoke its access and clean up resources.
  2. Automate the removal of cluster agents across projects during a CI/CD pipeline cleanup process.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for testing or public endpoints.
Authentication Type of authentication used, defaulting to GitLab API key authentication.
baseUrl 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 to specify the project ID or URL-encoded path and the cluster agent ID to delete.

Output

JSON

  • statusCode - HTTP status code of the delete operation response
  • responseBody - Response body returned by the GitLab API after deleting the cluster agent

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the project ID and agent ID are correctly specified and exist in GitLab to avoid 404 Not Found errors.
  • Authentication errors may occur if the API key is missing, invalid, or lacks sufficient permissions; verify the API key and its scopes.
  • Network or base URL misconfiguration can cause connection failures; confirm the baseUrl is correct and accessible.

Links

Discussion