opschain admin runner-group delete

Included from Basic tier

opschain admin runner-group delete <name>

Deletes a runner group nothing references (the v2 RunnerService.DeleteRunnerGroup RPC). Deletion is cleanup for groups nothing can enrol into any more: the server refuses it by name while any registered runner (or agent) still belongs to the group, or while any still-redeemable registration token names it. Clear the references first — drain and stop the members, forget their registrations, and let the group's tokens expire or exhaust.

Flags

Flag	Meaning
--server <url>	Server base URL. Default: the active context / OPSCHAIN_SERVER.
--auth-token <token>	Admin bearer token override. Default: your opschain login session, then $OPSCHAIN_ADMIN_TOKEN, then the token stored by opschain admin login.

Output

The server's acknowledgement, as JSON (-o yaml for YAML):

{
  "deleted": true,
  "name": "secure"
}

An info:runner:group_deleted event records who deleted what.

Exit codes

0 deleted; 1 the request failed or was refused; 2 usage.

Named errors

• a server is required — pass --server <url>, set OPSCHAIN_SERVER, or 'opschain context use <name>' (exit 2)
• this command needs a login or an admin token — run 'opschain login', pass --auth-token, set OPSCHAIN_ADMIN_TOKEN, or store one with 'opschain admin login' (exit 2)
• the server rejected the credential — run 'opschain login' again, or check the admin token (exit 1)
• runner group "<name>" is still referenced by <references> — 409 conflict (exit 1). The references name what blocks the delete and how each clears: N registered runner(s)/agent(s) — drain and stop them, then 'opschain admin runner forget', and/or N still-redeemable registration token(s) — let them expire or exhaust before deleting the group.
• An unknown group name reports the server's 404 (exit 1).

See also

• opschain docs cli/admin-runner-forget — clear a runner reference.
• opschain docs cli/admin-runner-token-list — see which of the group's tokens are still redeemable (STATUS active).
• opschain docs cli/admin-runner-group-set — recreate or repurpose a group instead of deleting it.