Scroll to navigation

GT-AUTH-TOKEN(1) gitea-cli Manual GT-AUTH-TOKEN(1)

NAME

gt-auth-token - Print the access token of an account

SYNOPSIS

gt auth token [flags]

DESCRIPTION

Print the access token that gt uses for the active account, or for --user, so that scripts can call the API themselves. The GITEA_TOKEN of the instance takes precedence, as it does for other commands, and an expiring OAuth token is refreshed first. Accounts that sign requests with an SSH key have no token.

OPTIONS

-h, --help[=false] help for token

OPTIONS INHERITED FROM PARENT COMMANDS

--debug[=false] Log the method, URL, status, and duration of each HTTP request to stderr

--host="" Gitea instance URL, including any base path

--interactive[=false] Allow prompts with machine output

--no-input[=false] Disable prompts and implicit editor/browser interactions

--sudo="" Perform API requests as this user (requires an administrator account)

--user="" Account name on the selected instance

EXAMPLE

$ gt auth token
$ curl -H "Authorization: token $(gt auth token)" https://gitea.com/api/v1/user
$ gt auth token --host gitea.com --user alice

SEE ALSO

gt-auth(1)

Nov 2026 gitea-cli