Runners
Retrieve a runner
Returns the Runner record with its server-derived health_status. For detailed telemetry (active jobs, capacity), use GetRunnerStatus instead.
Scope: runner:read
Authorization
bearerAuth AuthorizationBearer <token>
Personal Access Token (PAT) or Service Access Token (SAT). Pass the token in the Authorization header: Bearer adm_pat_...
In: header
Path Parameters
runner_id*runner_id
The unique identifier of the runner (UUID).
Format
uuidResponse Body
application/json
curl -X GET "https://admiral.example.com/api/v1/runners/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "runner": { "id": "b2c3d4e5-6789-0abc-def1-234567890abc", "name": "prod-terraform-runner", "description": "Terraform runner for production AWS infrastructure provisioning.", "kind": "RUNNER_KIND_TERRAFORM", "labels": { "cloud": "aws", "team": "platform" }, "health_status": "RUNNER_HEALTH_STATUS_HEALTHY", "created_by": "d290f1ee-6c54-4b01-90e6-d701748f0851", "updated_by": "d290f1ee-6c54-4b01-90e6-d701748f0851", "created_at": "2025-07-15T10:00:00Z", "updated_at": "2025-11-18T08:30:00Z" }}