Skip to main content
GET
List Runners

Overview

Retrieve all runners registered to your account with pagination support. Results are ordered by creation date (newest first).

Query Parameters

integer
Page number to retrieve (default: 1, minimum: 1).
integer
Number of runners per page (default: 10, minimum: 1, maximum: 100).
string
Filter runners by status (possible values: “active”, “disabled”)

Response

array
required
Array of runner objects.
integer
required
Total number of runners across all pages.

Runner Object

string
required
Unique identifier (UUID) for the runner.
string
required
UUID of the user who owns this runner.
string
required
The runner’s name.
string
required
Current status of the runner. Values: active, disabled
string
required
The URL where the runner is accessible.
string[]
required
Array of tags associated with the runner.
object
required
Custom headers configured for this runner.
string
required
ISO 8601 timestamp when the runner was created.
string
required
ISO 8601 timestamp when the runner was last updated.

Example Response

Error Responses

error
Unauthorized - invalid or missing authentication token.

Notes

  • Results are ordered by creation date (newest first)
  • The total field indicates the total count across all pages