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 duration 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 themselves (@me). These tokens must use the scope 'k8s_proxy'. For more information, see the GitLab documentation for the User tokens API ⟨https://docs.gitlab.com/api/user_tokens/#create-a-personal-access-token⟩.

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). Maximum: 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.

--jq=""
    Filter JSON output with a jq expression.

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

-R, --repo=""
    Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.

-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_tokens/#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)