1GH-AUTH-REFRESH(1)             GitHub CLI manual            GH-AUTH-REFRESH(1)
2
3
4

NAME

6       gh-auth-refresh - Refresh stored authentication credentials
7
8
9

SYNOPSIS

11       gh auth refresh [flags]
12
13
14

DESCRIPTION

16       Expand or fix the permission scopes for stored credentials.
17
18
19       The  --scopes  flag  accepts  a comma separated list of scopes you want
20       your gh credentials to have. If no scopes  are  provided,  the  command
21       maintains previously added scopes.
22
23
24       The  --remove-scopes  flag accepts a comma separated list of scopes you
25       want to remove from your gh credentials. Scope removal  is  idempotent.
26       The minimum set of scopes ("repo", "read:org" and "gist") cannot be re‐
27       moved.
28
29
30       The --reset-scopes flag resets the scopes for your  gh  credentials  to
31       the default set of scopes for your auth flow.
32
33
34

OPTIONS

36       -h, --hostname <string>
37              The GitHub host to use for authentication
38
39
40       --insecure-storage
41              Save authentication credentials in plain text instead of creden‐
42              tial store
43
44
45       -r, --remove-scopes <strings>
46              Authentication scopes to remove from gh
47
48
49       --reset-scopes
50              Reset authentication scopes to the default minimum set of scopes
51
52
53       -s, --scopes <strings>
54              Additional authentication scopes for gh to have
55
56
57

EXAMPLE

59              $ gh auth refresh --scopes write:org,read:public_key
60              # => open a browser to add write:org and read:public_key scopes
61
62              $ gh auth refresh
63              # => open a browser to ensure your authentication credentials have the correct minimum scopes
64
65              $ gh auth refresh --remove-scopes delete_repo
66              # => open a browser to idempotently remove the delete_repo scope
67
68              $ gh auth refresh --reset-scopes
69              # => open a browser to re-authenticate with the default minimum scopes
70
71
72
73
74

SEE ALSO

76       gh-auth(1)
77
78
79
80                                   Oct 2023                 GH-AUTH-REFRESH(1)
Impressum