glab(1)                                                                glab(1)



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)