Administer a fleet runner
Platform-admin mutation on a single runner. The body carries exactly one of action or assigned_policy. action moves the admin state: cordon to cordoned, drain to draining, revoke to revoked. Revoked is terminal; a revoked runner cannot transition back. assigned_policy re-assigns the runner’s policy, and the host picks it up on its next heartbeat. Sending the same policy again changes nothing and records no event.
Authorizations
Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth
Path Parameters
Runner id (UUIDv7).
Body
Exactly one of action or assigned_policy must be present; both or neither is a 400.
Response
The runner's admin state, plus the stored assignment on the policy-update path.