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



NAME
       gt-auth-refresh - Refresh an OAuth token



SYNOPSIS
       gt auth refresh [flags]



DESCRIPTION
       Refresh the OAuth token of the active account, or of --user, now. gt
       refreshes expiring OAuth tokens on its own; tokens pasted with --with-
       token cannot be refreshed and are replaced by logging in again.



OPTIONS
       -h, --help[=false]  help for refresh



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 refresh
       $ gt auth refresh --host gitea.com --user alice



SEE ALSO
       gt-auth(1)

gitea-cli                          Nov 2026                 GT-AUTH-REFRESH(1)