GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation deletes a specific runner from a project in GitLab using the GitLab API. It is useful for managing CI/CD runners associated with projects, allowing users to remove runners that are no longer needed or should no longer be associated with a project. For example, a DevOps engineer might use this node to automate the cleanup of runners after a project is archived or to revoke access for a runner that is compromised.

Use Case Examples

  1. Deleting a runner from a project to free up resources or revoke access.
  2. Automating project cleanup by removing all runners associated with a project before archiving it.

Properties

Name Meaning
Skip Authentication If set to true, the node will skip using authentication for the API request.
Authentication The authentication method used for the API request, defaulting to GitLab API authentication.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method The HTTP method used for the request, defaulting to DELETE for this operation.
Path Parameters The path parameters required for the API endpoint, including the project ID or URL-encoded path and the runner ID to delete.

Output

JSON

  • statusCode - The HTTP status code returned by the API after attempting to delete the runner.
  • body - The response body from the API, typically empty for a successful delete operation.

Dependencies

  • GitLab API authentication credential

Troubleshooting

  • Ensure the project ID and runner ID are correct and that the authenticated user has permission to delete runners for the project.
  • If authentication is skipped, the request may fail due to lack of authorization.
  • Check the base URL to ensure it points to the correct GitLab instance, especially if using a self-hosted GitLab server.

Links

Discussion