GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation resets the registration token for a specific project's runners in GitLab. It is useful when you want to invalidate the current registration token and generate a new one for security or administrative purposes. For example, if you suspect the token has been compromised or simply want to rotate it regularly, this operation allows you to do so by specifying the project ID.

Use Case Examples

  1. Reset the registration token for project ID 123 to ensure only authorized runners can register.
  2. Automate token rotation for project runners as part of a security compliance workflow.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the API request.
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 POST is used for this operation.
Path Parameters The path parameters required for the API call, specifically the project ID to identify which project's runner token to reset.

Output

JSON

  • id - The ID of the project for which the runner registration token was reset.
  • token - The new registration token generated for the project's runners.
  • message - Any message returned by the API, such as confirmation of the token reset.

Dependencies

  • GitLab API authentication token or credentials

Troubleshooting

  • Ensure the project ID provided in the path parameters is valid and accessible by the authenticated user.
  • If authentication is skipped, the request may fail due to lack of permissions.
  • Check that the base URL is correct and points to a valid GitLab instance.
  • Verify that the HTTP method is set to POST as required by this operation.

Links

Discussion