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

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

gt auth token [flags]

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.

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

--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

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

gt-auth(1)

Nov 2026 gitea-cli