Skip to main content
Version: v5.7.0

opschain admin runner-attributes remove

Included from Basic tier

opschain admin runner-attributes remove <key>

Removes a registered placement attribute key (the v2 RunnerService.DeleteRunnerAttribute RPC), taking it out of the vocabulary that group writes and run-creation selectors validate against. The product-seeded reserved keys (location, network) cannot be removed.

On success the command prints nothing (the server answers 204 No Content).

Flags​

FlagMeaning
--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.

Exit codes​

0 removed; 1 the request failed or the key is reserved; 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)
  • attribute key is reserved — 422, passed through (exit 1).

See also​

  • opschain docs cli/admin-runner-attributes-set — re-register a key, or clear a key's value restriction instead of removing it.
  • opschain docs cli/admin-runner-attributes-list — what is registered.