GitLab API icon

GitLab API

Gitlab

Actions1062

Runners → getApiV4Runners

AI-generated

Summary

Send a customized HTTP request to GitLab's /api/v4/runners endpoint using any supported method to retrieve or manipulate runner resources.

Inputs

  • Skip Authentication — Choose to skip using GitLab API authentication credentials for this request.
  • baseUrl — Set the base URL for the GitLab instance; defaults to https://gitlab.com.
  • Method (required) — HTTP method to use for the request; options include GET, POST, PUT, DELETE, HEAD, PATCH.
  • Query Parameters — Specify query parameters to filter runner results, such as scope, type, paused, status, tag_list, version_prefix, page, and per_page.

Output shape

a JSON response from the GitLab API representing runner data or the outcome of the HTTP request

Supports pagination via page and per_page parameters. Returns data depending on HTTP method used; typically returns runner objects for GET requests. Requires authentication unless 'Skip Authentication' is enabled.

Examples

Example 1: Fetch active shared runners with tag 'shell' and version prefix '16.'

Method: GET; Query Parameters: status=active, scope=shared, tag_list=['shell'], version_prefix='16.'

Links

Discussion