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, with	 expiration  occurring
       at midnight UTC on the calculated date. Alternatively you can specify a
       different  duration using days (d), weeks (w), or hours (h), or provide
       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=30d      Sets the	token lifetime in days.	Accepts:  days
       (30d), weeks (4w), or hours in multiples	of 24 (24h, 168h, 720h). Maxi-
       mum: 365d. The token expires at midnight	UTC on the calculated date.

       -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	(default 30 days)
       $ glab token rotate my-project-token

       # Rotate	project	access token with explicit expiration date
       $ glab token rotate --repo user/repo my-project-token --expires-at 2025-08-08

       # Rotate	group access token with	7 day lifetime
       $ glab token rotate --group group/sub-group my-group-token --duration 7d

       # Rotate	personal access	token with 2 week lifetime
       $ glab token rotate --user @me my-personal-token	--duration 2w

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

SEE ALSO
       glab-token(1)

Auto generated by spf13/cobra	   Mar 2026			       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.quarterly>

home | help