NAME

       gh-auth-refresh - Refresh stored authentication credentials

SYNOPSIS

       gh auth refresh [flags]

DESCRIPTION

       Expand or fix the permission scopes for stored credentials.

       The --scopes flag accepts a comma separated list of scopes you want your gh credentials to
       have. If no scopes are provided, the command maintains previously added scopes.

       The command can only add additional scopes, but not remove previously added ones. To reset
       scopes to the default minimum set of scopes, you will need to create new credentials using
       the auth login command.

OPTIONS

       -h, --hostname <string>
              The GitHub host to use for authentication

       --insecure-storage
              Save authentication credentials in plain text instead of credential store

       -s, --scopes <strings>
              Additional authentication scopes for gh to have

EXAMPLE

              $ gh auth refresh --scopes write:org,read:public_key
              # => open a browser to add write:org and read:public_key scopes for use with gh api

              $ gh auth refresh
              # => open a browser to ensure your authentication credentials have the correct minimum scopes

SEE ALSO

       gh-auth(1)

                                             Jan 2024                          GH-AUTH-REFRESH(1)