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

FreeBSD Manual Pages

  
 
  

home | help 
glab(1)								       glab(1)

NAME
       glab-token-create - Creates user, group,	or project access tokens.

SYNOPSIS
       glab token create  [flags]

DESCRIPTION
       Creates a new access token for a	user, group, or	project. Defaults to a
       project access token, unless user or group name is specified.

       The  expiration	date of	the token is calculated	by adding the duration
       (default: 30 days) to the current date, with  expiration	 occurring  at
       midnight	 UTC on	the calculated date. You can specify a different dura-
       tion using days (d), weeks (w), or hours	(h), or	 provide  an  explicit
       end date.

       The name	of the token must be unique. The token is printed to stdout.

       Administrators  can  create  full-featured  personal  access tokens for
       themselves and for other	users.

       Non-administrators can create personal access  tokens  only  for	 them-
       selves (@me). These tokens must use the scope 'k8s_proxy'. For more in-
       formation,  see	the  GitLab  documentation  for	 the  User  tokens API
       <https://docs.gitlab.com/api/user_tokens/#create-a-personal-access-to-
       ken>.

OPTIONS
       -A, --access-level=no	  Access level of the token: one  of  'guest',
       'reporter', 'developer',	'maintainer', 'owner'.

       --description=""	     Sets the token's description.

       -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=""	     Create a group access token. Ignored if a user or
       repository argument is set.

       -F, --output="text"	Format output as 'text'	for the	 token	value,
       'json' for the actual API token structure.

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

       -S,  --scope=[read_repository]	    Scopes  for	 the  token.  Multiple
       scopes can be comma-separated or	specified by repeating the flag. For a
       list,   see    https://docs.gitlab.com/user/profile/personal_access_to-
       kens/#personal-access-token-scopes.

       -U,  --user=""	    Create  a  personal	 access	token. For the current
       user, use @me.

OPTIONS	INHERITED FROM PARENT COMMANDS
       -h, --help[=false]      Show help for this command.

EXAMPLE
       # Create	project	access token for current project (default 30 days)
       $ glab token create --access-level developer --scope read_repository --scope read_registry my-project-token

       # Create	project	access token with 7 day	lifetime
       $ glab token create --repo user/my-repo --access-level owner --scope api	my-project-token --duration 7d

       # Create	a group	access token expiring in 2 weeks
       $ glab token create --group group/sub-group --access-level owner	--scope	api my-group-token --duration 2w

       # Create	a personal access token	for current user with 90 day lifetime
       $ glab token create --user @me --scope k8s_proxy	my-personal-token --duration 90d

       # (administrator	only) Create a personal	access token for another user
       $ glab token create --user johndoe --scope api johns-personal-token --duration 180d

       # Create	a token	with explicit expiration date
       $ glab token create --access-level developer --scope api	my-token --expires-at 2025-12-31

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-create&sektion=1&manpath=FreeBSD+Ports+15.0.quarterly>

home | help