GitLab API

GitlabTool

Actions1000

Overview

This node operation resets the registration token for GitLab runners via the GitLab API. It is useful for administrators who need to invalidate the current registration token and generate a new one to enhance security or manage runner registrations. For example, if a registration token is compromised, this operation can be used to reset it quickly.

Use Case Examples

  1. Resetting the registration token for GitLab runners to prevent unauthorized runner registrations.
  2. Automating the process of rotating registration tokens for GitLab runners as part of a security policy.

Properties

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

Output

JSON

  • response - The JSON response from the GitLab API after resetting the registration token.

Dependencies

  • GitLab API authentication credential

Troubleshooting

  • Ensure the GitLab API authentication credential is correctly configured and has sufficient permissions to reset runner registration tokens.
  • Verify the baseUrl is correct and accessible from the n8n instance.
  • Check that the HTTP method is set to POST as required by the reset registration token endpoint.
  • Common error messages may include authentication failures, permission denied, or invalid endpoint errors. Verify credentials and endpoint path to resolve these.

Links

Discussion