GitLab API icon

GitLab API

Gitlab

Actions1062

Groups → postApiV4GroupsIdRunnersResetRegistrationToken

AI-generated

Summary

Reset the registration token for a specific group to invalidate existing runner registrations and generate a new token.

Inputs

  • Id (required) — The ID of the group whose runners' registration token will be reset.
  • Skip Authentication — Optionally skip authentication for this API call.
  • baseUrl — The base URL of the GitLab instance, defaulting to https://gitlab.com.

Output shape

a JSON object with the updated group's runner registration token information

The response contains the updated registration token after reset. The operation requires the group ID as a path parameter and returns the new token details. Authentication is required unless explicitly skipped.

Examples

Example 1: Reset runner registration token for group 123

Provide '123' as the group ID. Optional baseUrl can be changed if using a self-hosted GitLab.

Links

Discussion