grafana-util docs

grafana-util-access-service-account-token.1

Browser-readable rendering of a generated roff manpage.

This page renders the generated roff manpage into readable HTML for browser use. For richer per-subcommand detail, prefer the command-reference pages.

NAME

grafana-util-access-service-account-token - Add or delete tokens for a Grafana service account.

SYNOPSIS

grafana-util access service-account token [OPTIONS]

DESCRIPTION

Add or delete tokens for a Grafana service account.

  • Create a new service-account token.
  • Delete an existing service-account token by service-account name or id.

BEFORE / AFTER

  • Before: service-account token work often happens ad hoc in the Grafana UI, with no easy way to repeat the same action in another environment.
  • After: token creation and cleanup become explicit CLI steps that can be reviewed, scripted, and repeated for the same service account.

COMMON OPTIONS

add
--service-account-id or --name, --token-name, --seconds-to-live, --json
delete
--service-account-id or --name, --token-name, --yes, --json

SUCCESS CRITERIA

  • token creation is tied to one named service account instead of relying on a manual UI lookup
  • token cleanup is deliberate and auditable, especially when you script deletion with --yes
  • automation can capture the JSON result when it needs to hand the token or delete confirmation to another step

FAILURE CHECKS

  • if token creation fails, confirm whether you targeted the right service account by --name or --service-account-id
  • if deletion looks like a no-op, recheck the token name and whether you are pointing at the correct Grafana org or environment
  • if you plan to pass the result into automation, use --json and validate the response shape before storing or forwarding it

EXAMPLES

Add or delete tokens for a Grafana service account.

grafana-util access service-account token add --profile prod --name deploy-bot --token-name nightly

SEE ALSO

grafana-util(1), grafana-util-access(1)