gh-auth-refresh - Man Page

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)

Referenced By

gh-auth(1).

May 2023 GitHub CLI manual