GitLab API

GitlabTool

Actions1095

Groups → getApiV4GroupsIdRunners

AI-generated

Summary

Retrieve runners associated with a specific GitLab group, optionally filtering by runner type, status, tags, and pagination parameters.

Inputs

  • id (required) — The ID of the GitLab group whose runners to fetch.
  • type — Filter runners by type: instance_type, group_type, or project_type.
  • paused — Filter to only include runners that are paused or not accepting jobs.
  • status — Filter runners by status: active, paused, online, offline, never_contacted, or stale.
  • tag_list — Comma-separated list of runner tags to filter by.
  • version_prefix — Filter runners by version prefix (e.g., '15.1.', '16.').
  • page — Page number of paginated results to fetch (default 1).
  • per_page — Number of runners to return per page (default 20).

Output shape

a paginated collection of runner objects associated with the specified group.

Supports pagination through 'page' and 'per_page' query parameters. Optional filters can be applied to refine returned runners by type, status, tags, paused state, and version prefix. Authentication is required unless 'Skip Authentication' is enabled.

Links

Discussion