---
name: "gt-auth-token"
section: "1"
platform: "linux"
package: "gitea-cli"
version: "1.0.0-1"
release: "Arch Linux 2026-11-07"
platforms: ["linux"]
url: "https://carta.tech/man/gt-auth-token"
---

# gt-auth-token(1)

Print the access token of an account

## 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)](/man/gt-auth/1.md)**