From 2d261450bc3554f628ca98ca570c36635eaad966 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Tue, 12 May 2026 20:21:32 +0000 Subject: [PATCH] Document mmctl roles list (v11.7.0) Add reference entry for the new `mmctl roles list` subcommand introduced in mattermost/mattermost#34064 (milestone v11.7.0). Description follows the PR-evidence-safe wording; permission note links the existing local mode anchor; child-specific Options block omitted since the exact help string was not in PR evidence. Resolves #8964. Co-authored-by: Combs7th --- .../manage/mmctl-command-line-tool.rst | 41 +++++++++++++++++++ 1 file changed, 41 insertions(+) diff --git a/source/administration-guide/manage/mmctl-command-line-tool.rst b/source/administration-guide/manage/mmctl-command-line-tool.rst index 16a340423e1..4010287073c 100644 --- a/source/administration-guide/manage/mmctl-command-line-tool.rst +++ b/source/administration-guide/manage/mmctl-command-line-tool.rst @@ -5731,6 +5731,47 @@ Remove system admin privileges from multiple users: **Options inherited from parent commands** +.. code-block:: sh + + --config string path to the configuration file (default "$XDG_CONFIG_HOME/mmctl/config") + --disable-pager disables paged output + --insecure-sha1-intermediate allows to use insecure TLS protocols, such as SHA-1 + --insecure-tls-version allows to use TLS versions 1.0 and 1.1 + --json the output format will be in json format + --local allows communicating with the server through a unix socket + --quiet prevent mmctl to generate output for the commands + --strict will only run commands if the mmctl version matches the server one + --suppress-warnings disables printing warning messages + +mmctl roles list +~~~~~~~~~~~~~~~~ + +**Description** + +From Mattermost v11.7.0, you can list all available roles and discover role names, such as ``system_admin`` or ``system_user``. + +.. note:: + + This command requires system admin privileges, or `local mode <#local-mode>`__. + +**Format** + +.. code-block:: sh + + mmctl roles list [flags] + +**Examples** + +.. code-block:: sh + + # List all available role names + $ mmctl roles list + + # List all available role objects in JSON format + $ mmctl roles list --json + +**Options inherited from parent commands** + .. code-block:: sh --config string path to the configuration file (default "$XDG_CONFIG_HOME/mmctl/config")