Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 dura-
       tion (default 30	days) to the current date. Alternatively you can spec-
       ify 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 cur-
       rent user.

OPTIONS	INHERITED FROM PARENT COMMANDS
       -h, --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 2025			       glab(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=glab-token-rotate&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help