List Runners
Runners
List Runners
Retrieve a paginated list of your runners
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, disabledstring
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
totalfield indicates the total count across all pages