GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation resets the registration token for runners in a specified GitLab group. It is useful for GitLab administrators who want 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 or needs to be rotated regularly, this operation can be used to reset it.

Use Case Examples

  1. Resetting the registration token for a group to prevent unauthorized runner registrations.
  2. Automating token rotation for GitLab group runners 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 to which the request is sent.
Method The HTTP method used for the request, here it is POST for resetting the token.
Path Parameters The path parameters for the request, specifically the group ID whose runners' registration token is to be reset.

Output

JSON

  • token - The new registration token for the group's runners after reset.
  • group_id - The ID of the group for which the token was reset.

Dependencies

  • Requires GitLab API authentication credentials (API key or token).

Troubleshooting

  • Ensure the group ID provided in the path parameters is valid and accessible with the provided credentials.
  • Check that the authentication credentials have sufficient permissions to reset runner registration tokens for the group.
  • If the request fails, verify the base URL is correct and the GitLab instance is reachable.
  • Common error messages may include authorization errors (e.g., 401 Unauthorized) or not found errors (e.g., 404 if the group ID does not exist).

Links

Discussion