Manage Runners Logo
Manage Runners
Documentation menu

manage-runners external-runner delete

Delete an external runner and end its agent's credential; the server keeps the agent until its uninstall command runs; --name also needs runners:read

Required scopes runners:delete
Required flags none
Changes state yes
Destructive yes
Paid resource effect none
Confirmation runner_id
Non-interactive use supported

This command permanently removes data. Read confirmations before running it non-interactively.

Usage

Delete an external runner and end its agent's credential; the server keeps the agent until its uninstall command runs; --name also needs runners:read

Usage:
  manage-runners external-runner delete [flags]

Flags:
      --confirm string   external runner id confirmation
      --id string        external runner id
      --name string      exact external runner name; resolving it needs runners:read
      --profile string   configuration profile
      --yes              confirm the destructive operation

Every command also accepts the global flags. For machine-readable help, run manage-runners help external-runner delete --output json.