GitLab API icon

GitLab API

Gitlab

Actions1062

Runners → getApiV4ProjectsIdRunners

AI-generated

Summary

Retrieve a list of runners available for a specified GitLab project, applying optional filters such as runner type, status, tags, and version prefix.

Inputs

  • id (required) — The ID or URL-encoded path of the project owned by the authenticated user.
  • scope — Deprecated filter for runner scope; use 'type' or 'status' instead.
  • type — The type of runners to return (instance_type, group_type, or project_type).
  • paused — Boolean filter to include only runners that are paused or accepting new jobs.
  • status — The status of runners to return (active, paused, online, offline, never_contacted, stale).
  • tag_list — List of runner tags to filter by.
  • version_prefix — Version prefix string to filter runners by their version.
  • page — Page number for paginated results (default 1).
  • per_page — Number of runners to return per page (default 20).

Output shape

a paginated list of runner objects associated with the specified project

Supports pagination via 'page' and 'per_page' query parameters; filters such as 'type', 'status', and 'tag_list' refine the returned runners. The operation uses a GET method to '/api/v4/projects/{id}/runners' endpoint. Authentication is required unless 'Skip Authentication' is set to true.

Links

Discussion