NAME

       glab-token-rotate - Rotate user, group, or project access tokens

SYNOPSIS

       glab token rotate  [flags]

DESCRIPTION

       Rotate  user, group, or project access token, then print the new token on stdout. If multiple tokens with
       the same name exist, you can specify the ID of the token.

       The expiration date of the token will be calculated by adding the  duration  (default  30  days)  to  the
       current date. Alternatively you can specify a different duration or an explicit end date.

       The  output  format can be either "JSON" or "text". The JSON output will show the meta information of the
       rotated token.

       Administrators can rotate personal access tokens belonging to other users.

OPTIONS

       -D, --duration=720h0m0s      Sets the token duration, in hours. Maximum of  8760.  Examples:  24h,  168h,
       504h.

       -E,  --expires-at=0001-01-01      Sets the token's expiration date and time, in YYYY-MM-DD format. If not
       specified, --duration is used.

       -g, --group=""      Rotate group access token. Ignored if a user or repository argument is set.

       -F, --output="text"      Format output as: text, json.  'text'  provides  the  new  token  value;  'json'
       outputs the token with metadata.

       -R,  --repo=""       Select another repository. Can use either OWNER/REPO or GROUP/NAMESPACE/REPO format.
       Also accepts full URL or Git URL.

       -U, --user=""      Rotate personal access token. Use @me for the current user.

OPTIONS INHERITED FROM PARENT COMMANDS

       --help[=false]      Show help for this command.

EXAMPLE

       # Rotate project access token of current project
       glab token rotate  my-project-token

       # Rotate project access token of another project, set to expiration date
       glab token rotate --repo user/repo my-project-token --expires-at 2024-08-08

       # Rotate group access token
       glab token rotate --group group/sub-group my-group-token

       # Rotate personal access token and extend duration to 7 days
       glab token rotate --user @me --duration $((7 * 24))h my-personal-token

       # Rotate a personal access token of another user (administrator only)
       glab token rotate --user johndoe johns-personal-token

SEE ALSO

       glab-token(1)

Auto generated by spf13/cobra                       Nov 2024                                             glab(1)