GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation deletes a specific runner from a project in GitLab. It is useful for managing CI/CD runners associated with projects, especially when a runner is no longer needed or should be removed for security or maintenance reasons. For example, a DevOps engineer might use this node to remove an outdated or compromised runner from a project to ensure only authorized runners are used.

Use Case Examples

  1. Remove a runner with ID 123 from project 'my-project' to stop it from running jobs on that project.
  2. Automate cleanup of runners for projects that are archived or no longer active.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
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 required in the URL path to identify the project and runner to delete.

Output

JSON

  • statusCode - HTTP status code of the delete operation response.
  • responseBody - Response body returned from the GitLab API after deleting the runner.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the project ID and runner ID are correct and exist in GitLab to avoid 404 errors.
  • Authentication errors may occur if the API key is missing or invalid; verify credentials.
  • Permission errors can happen if the API key does not have rights to manage runners on the project.

Links

Discussion