Skip to main content

​
crocbot devices

Manage device-scoped tokens.

​
Commands

​
crocbot devices list

List registered devices and their tokens. 
crocbot devices list
crocbot devices list --json

​
crocbot devices rotate --device <id> --role <role> [--scope <scope...>]

Rotate a device token for a specific role (optionally updating scopes). 
crocbot devices rotate --device <deviceId> --role operator --scope operator.read --scope operator.write

​
crocbot devices revoke --device <id> --role <role>

Revoke a device token for a specific role. 
crocbot devices revoke --device <deviceId> --role node

​
Common options

  • --url <url>: Gateway WebSocket URL (defaults to gateway.remote.url when configured).
  • --token <token>: Gateway token (if required).
  • --password <password>: Gateway password (password auth).
  • --timeout <ms>: RPC timeout.
  • --json: JSON output (recommended for scripting).

​
Notes

  • Token rotation returns a new token (sensitive). Treat it like a secret.
  • These commands require operator.admin scope.