GitLab API icon

GitLab API

Gitlab

Actions1062

Runners → getApiV4RunnersAll

AI-generated

Summary

Retrieve a list of all GitLab runners accessible via the /api/v4/runners/all endpoint, optionally filtering by parameters such as scope, type, status, tags, version prefix, and pagination settings.

Inputs

  • skipAuthentication — Boolean to skip authentication; defaults to false, meaning authentication with GitLab API credentials is used.
  • baseUrl — Base URL of the GitLab instance, defaults to https://gitlab.com.
  • method (required) — HTTP method to use, default is GET.
  • queryParameters — Collection of query parameters to filter the runners, including scope (deprecated), type (instance, group, or project), paused status, runner status (e.g., active, paused, online), tag_list, version prefix, page number, and items per page.

Output shape

a list of runner objects as returned by the GitLab API's /api/v4/runners/all endpoint

Supports pagination via 'page' and 'per_page' query parameters. Optional filters can be applied with query parameters. The node requires GitLab API credentials unless authentication is skipped.

Examples

Example 1: List all GitLab runners with default settings.

Use the default GET method and no query parameters to retrieve the initial page of runners.

Example 2: Filter runners to only active instance-type runners.

Set 'type' query parameter to 'instance_type' and 'status' to 'active' in query parameters.

Example 3: Paginate through runners with 50 runners per page.

Set 'page' query parameter to desired page number and 'per_page' to 50.

Links

Discussion