GitLab API

GitlabTool

Actions1095

Runners → postApiV4Runners

AI-generated

Summary

Create a new GitLab runner by sending a POST request to the /api/v4/runners endpoint with the required runner configuration in the request body.

Inputs

  • requestBodySchema (required) — The runner configuration object matching the postApiV4Runners schema, specifying details such as runner description, tags, and other settings.
  • baseUrl — The base URL of the GitLab instance to which the request is sent; defaults to 'https://gitlab.com'.
  • skipAuthentication — Whether to bypass authentication; defaults to false, meaning authentication is required using the gitlabApi credential.

Output shape

a single record representing the newly created runner as returned by the GitLab API

The output contains runner details as provided by the GitLab API response when creating a runner. Errors or failures in the request will be returned as error responses.

Examples

Example 1: Create a new GitLab runner with specific tags and description

Set the requestBodySchema with the runner's description, tags, and other required fields. Use the default baseUrl or specify a self-managed GitLab instance URL if needed. Ensure authentication via the gitlabApi credential is enabled.

Links

Discussion