grafana-util docs
Home / Manpages / grafana-util-access-team.1

grafana-util-access-team.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-team - List or browse live and local Grafana teams, create, modify, export, import, diff, or delete Grafana teams.

SYNOPSIS

grafana-util access team [OPTIONS]

DESCRIPTION

List or browse live and local Grafana teams, create, modify, export, import, diff, or delete Grafana teams.

  • Inspect team inventory and team memberships.
  • Inspect teams from a live Grafana server or from a local export bundle.
  • Create or update team membership and admin assignments.
  • Export or import team bundles.
  • Remove a team by id or exact name.

BEFORE / AFTER

  • Before: team membership changes often happen through UI side menus or scattered scripts.
  • After: one namespace handles inventory, membership updates, export/import, and deletion with the same auth model.

COMMON OPTIONS

list
--input-dir, --query, --name, --with-members, --page, --per-page, --table, --csv, --json, --yaml, --output-format
browse
--input-dir, --query, --name, --with-members, --page, --per-page
add
--name, --email, --member, --admin, --json
modify
--team-id, --name, --add-member, --remove-member, --add-admin, --remove-admin, --json
export and diff
--output-dir or --diff-dir, --overwrite, --dry-run, --with-members
import
--input-dir, --replace-existing, --dry-run, --table, --json, --output-format, --yes
delete
--team-id, --name, --yes, --json

SUCCESS CRITERIA

  • team membership changes stay tied to an exact team id or name
  • admin assignments are visible before you add or remove members
  • exported bundles can be reused in another environment without re-creating the team by hand

FAILURE CHECKS

  • if list, add, modify, or delete fails, confirm the team exists in the selected org and the auth scope is correct
  • if membership looks incomplete, recheck the exact member names and whether --with-members was set
  • if an import behaves unexpectedly, verify the source bundle and the target environment before retrying

EXAMPLES

List or browse live and local Grafana teams, create, modify, export, import, diff, or delete Grafana teams.

grafana-util access team list --url http://localhost:3000 --basic-user admin --basic-password admin --output-format text

SEE ALSO

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