gh-auth-refresh - Man Page

Refresh stored authentication credentials


gh auth refresh [flags]


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.


-h, ā€‰--hostname <string>

The GitHub host to use for authentication


Save authentication credentials in plain text instead of credential store

-s, ā€‰--scopes <strings>

Additional authentication scopes for gh to have


$ 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


Referenced By


May 2023 GitHub CLI manual