Back to Mattermost

mmctl token rotate

server/cmd/mmctl/docs/mmctl_token_rotate.rst

11.10.01.5 KB
Original Source

.. _mmctl_token_rotate:

mmctl token rotate

Rotate a personal access token

Synopsis



Generate a new secret for an existing personal access token, immediately invalidating the old secret. Use --expires-in to set a new expiry.

::

  mmctl token rotate [token-id] [flags]

Examples

::

rotate xwt6numaubyj9mqjfkqjk5pfqr
rotate xwt6numaubyj9mqjfkqjk5pfqr --expires-in 90d

Options


::

      --expires-in string   New expiry duration for the rotated token (e.g. 90d, 12h). If empty, the token does not expire (subject to server policy).
  -h, --help                help for rotate

Options inherited from parent commands

::

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

SEE ALSO


* `mmctl token <mmctl_token.rst>`_ 	 - manage users' access tokens