Runners
Delete a runner
Scope: runner:write
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 to delete (UUID). All associated service access tokens will be revoked.
Format
uuidResponse Body
application/json
curl -X DELETE "https://admiral.example.com/api/v1/runners/497f6eca-6276-4993-bfeb-53cbbbba6f08"{}Create a runner token POST
Use this to create additional SATs for an existing runner (e.g., for zero-downtime token rotation). The initial SAT is created automatically by CreateRunner. Scope: `runner:write`
Retrieve a runner GET
Returns the Runner record with its server-derived health_status. For detailed telemetry (active jobs, capacity), use GetRunnerStatus instead. Scope: `runner:read`