GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation resets the registration token for a specific group in GitLab. It is useful for administrators who want to invalidate the current registration token used by runners in a group and generate a new one, enhancing security or managing runner access. For example, if a registration token is compromised or needs to be rotated, this operation can be triggered to reset it.

Use Case Examples

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

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.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method The HTTP method to use for the request, default is GET but POST is used for this operation.
Path Parameters The path parameters for the request, specifically the group ID whose runner registration token is to be reset.

Output

JSON

  • id - The ID of the group for which the registration token was reset.
  • runners_token - The new runners registration token for the group.

Dependencies

  • GitLab API authentication credential

Troubleshooting

  • Ensure the group ID provided in the path parameters is valid and the authenticated user has permission to reset the registration token for that group.
  • If authentication is skipped, the request may fail due to lack of authorization.
  • Verify the base URL is correct and accessible.
  • Common error messages include 401 Unauthorized (authentication issues), 404 Not Found (invalid group ID), and 403 Forbidden (insufficient permissions). Resolving these involves checking credentials, permissions, and input parameters.

Links

Discussion