GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation deletes a specific runner from a project in GitLab. It is useful for managing CI/CD runners by removing those that are no longer needed or should no longer be associated with a project. For example, a DevOps engineer can use this node to clean up runners after project changes or decommissioning.

Use Case Examples

  1. Deleting a runner with ID 123 from a project with ID 'my-project' to stop it from running jobs for that project.
  2. Removing an old or compromised runner from a project to maintain security and resource management.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the request.
Authentication The authentication method used for the request, typically an API key credential for GitLab.
baseUrl The base URL of the GitLab instance to which the request is sent.
Method The HTTP method used 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

  • success - Indicates whether the runner was successfully deleted (true/false).
  • statusCode - HTTP status code returned by the GitLab API for the delete operation.

Dependencies

  • GitLab API authentication credential

Troubleshooting

  • Ensure the project ID and runner ID are correct and exist in GitLab.
  • Verify that the API authentication token has sufficient permissions to delete runners.
  • Check the base URL to confirm it points to the correct GitLab instance.
  • Common error: 404 Not Found - The specified project or runner does not exist or is not accessible.
  • Common error: 401 Unauthorized - Authentication failed or token lacks required scopes.

Links

Discussion