GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation resets the authentication token for GitLab runners via the GitLab API. It is useful for administrators who need to invalidate and regenerate runner tokens for security or operational reasons. For example, if a runner's token is compromised, this operation can be used to reset it to prevent unauthorized access.

Use Case Examples

  1. Resetting a runner's authentication token to secure CI/CD pipelines after a security incident.
  2. Automating the token reset process for runners as part of routine maintenance or rotation policies.

Properties

Name Meaning
Skip Authentication Option to skip API authentication, useful for testing or when authentication is handled externally.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET but can be set to POST, PUT, DELETE, HEAD, or PATCH.

Output

JSON

  • response - The JSON response from the GitLab API after resetting the runner's authentication token, typically containing the new token and related runner information.

Dependencies

  • GitLab API authentication credential

Troubleshooting

  • Ensure the GitLab API credential is correctly configured and has sufficient permissions to reset runner tokens.
  • Verify the baseUrl is correct and accessible from the n8n instance.
  • Common errors include authentication failures, permission denied errors, and invalid endpoint paths. Check the API response message for details and adjust credentials or permissions accordingly.

Links

Discussion