GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation resets the registration token for runners in a specified 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 by providing the group ID.
  2. Use this operation to manage runner access by periodically resetting the registration token.

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, 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 API request, specifically the group ID to identify which group's runners' registration token to reset.

Output

JSON

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

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 skipping authentication, ensure the GitLab instance allows unauthenticated requests for this operation, which is uncommon.
  • Check the base URL to confirm it points to the correct GitLab instance, especially if using a self-hosted GitLab server.

Links

Discussion