GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation retrieves a list of all runners from the GitLab API (version 4). It is useful for scenarios where you need to manage or monitor runners across your GitLab instance, such as fetching runner details for automation, reporting, or integration purposes. For example, you can use it to get all active runners or filter runners by type or status.

Use Case Examples

  1. Fetch all runners to monitor their status and usage.
  2. Retrieve runners filtered by type (instance, group, or project) for targeted management.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the API request.
baseUrl The base URL of the GitLab instance to connect to.
Method HTTP method to use for the API request (GET, POST, PUT, DELETE, HEAD, PATCH).
Query Parameters Parameters to filter and paginate the runners list.

Output

JSON

  • runners - Array of runner objects returned by the GitLab API, each containing details about a runner such as its ID, status, type, tags, and version.

Dependencies

  • GitLab API authentication credential

Troubleshooting

  • Ensure the GitLab API base URL is correct and accessible.
  • Verify that the API authentication token is valid and has sufficient permissions to list runners.
  • Check query parameters for correct types and valid values to avoid API errors.
  • If skipping authentication, ensure the GitLab instance allows unauthenticated access to runners (rare).

Links

Discussion