GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation resets the registration token for runners in a specific GitLab group. It is useful for administrators who want to invalidate the current registration token and generate a new one to control runner registrations within a group. For example, if a token is compromised or needs to be refreshed for security reasons, this operation can be used to reset it.

Use Case Examples

  1. Reset the registration token for runners in a GitLab group with ID '12345' to prevent unauthorized runner registrations.
  2. Use this operation to rotate the registration token periodically as part of security best practices.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the request (boolean). Defaults to false.
Authentication The authentication method used for the request, typically an API key credential for GitLab.
baseUrl The base URL of the GitLab instance. Defaults to https://gitlab.com.
Method The HTTP method used for the request. Defaults to GET but for this operation it is POST.
Path Parameters The path parameters for the request, specifically the group ID whose runners' registration token is to be reset.

Output

JSON

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

Dependencies

  • GitLab API authentication token

Troubleshooting

  • Ensure the group ID provided in the path parameters is valid and exists in the GitLab instance.
  • Verify that the API authentication token has sufficient permissions to reset the runners' registration token for the group.
  • If authentication is skipped, the request may fail due to lack of authorization.
  • Check the base URL to ensure it points to the correct GitLab instance, especially if using a self-hosted GitLab server.

Links

Discussion