GitLab API

GitlabTool

Actions1095

Projects → getApiV4ProjectsIdRunners

AI-generated

Summary

Retrieve a paginated list of GitLab runners associated with a specific project using various 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 the scope of runners to return; use 'type' or 'status' instead.
  • type — Filter by the type of runners to return: instance_type, group_type, or project_type.
  • paused — Boolean indicating whether to include only runners that are paused (ignoring new jobs) or active.
  • status — Filter runners by their status: active, paused, online, offline, never_contacted, or stale.
  • tag_list — List of runner tags to filter by.
  • version_prefix — Filter runners by version prefix, e.g., '15.1.' or '16.'.
  • page — The page number to retrieve for paginated results (default is 1).
  • per_page — Number of items to return per page (default is 20).
  • skipAuthentication — Optionally skip authentication (default is false).
  • baseUrl — Base URL of the GitLab instance, defaulting to https://gitlab.com.

Output shape

a list of runner objects associated with the specified project, potentially paginated

The output may be paginated according to 'page' and 'per_page' parameters. Authentication is required unless 'Skip Authentication' is set to true. The node performs an HTTP GET request against the /api/v4/projects/{id}/runners endpoint with the provided filters.

Links

Discussion