GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation resets the registration token for GitLab runners by making a POST request to the GitLab API endpoint `/api/v4/runners/reset_registration_token`. It is useful for administrators who need to invalidate the current registration token and generate a new one for security or operational reasons.

Use Case Examples

  1. An admin wants to reset the registration token for all runners in their GitLab instance to prevent unauthorized runner registrations.
  2. Automating the process of rotating runner registration tokens as part of a security policy.

Properties

Name Meaning
Skip Authentication Determines whether to skip authentication for the API request.
Authentication Specifies the authentication method to use, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to which the API request is sent.
Method The HTTP method used for the API request, defaulting to GET but can be set to POST, PUT, DELETE, HEAD, or PATCH.

Output

JSON

  • token - The new registration token for GitLab runners returned by the API after reset.

Dependencies

  • GitLab API key credential

Troubleshooting

  • If authentication fails, ensure the GitLab API key credential is correctly configured and has sufficient permissions.
  • If the API endpoint `/api/v4/runners/reset_registration_token` is incorrect or unavailable, verify the GitLab instance URL and API version.
  • Network issues or incorrect base URL can cause request failures; verify connectivity and URL correctness.

Links

Discussion