The client ID of your GitHub app.
Delete an app authorization
OAuth application owners can revoke a grant for their OAuth application and a specific user. You must use Basic Authentication when accessing this endpoint, using the OAuth application’s client_id
and client_secret
as the username and password. You must also provide a valid OAuth access_token
as an input parameter and the grant for the token’s owner will be deleted.
Deleting an OAuth application’s grant will also delete all OAuth tokens associated with the application for the user. Once deleted, the application will have no access to the user’s account and will no longer be listed on the application authorizations settings screen within GitHub.
Path Parameters
Body
application/json
Body
The OAuth access token used to authenticate to the GitHub API.
Response
Response
Response
Path Parameters
Body
Revoke a grant for an application
DEPRECATEDDeprecation Notice: GitHub Enterprise Server will discontinue OAuth endpoints that contain access_token
in the path parameter. We have introduced new endpoints that allow you to securely manage tokens for OAuth Apps by moving access_token
to the request body. For more information, see the blog post.
OAuth application owners can revoke a grant for their OAuth application and a specific user. You must use Basic Authentication when accessing this endpoint, using the OAuth application’s client_id
and client_secret
as the username and password. You must also provide a valid token as :access_token
and the grant for the token’s owner will be deleted.
Deleting an OAuth application’s grant will also delete all OAuth tokens associated with the application for the user. Once deleted, the application will have no access to the user’s account and will no longer be listed on the Applications settings page under “Authorized OAuth Apps” on GitHub Enterprise Server.
Path Parameters
The client ID of your GitHub app.
Response
204
Response
Response
Path Parameters
Check a token
OAuth applications can use a special API method for checking OAuth token validity without exceeding the normal rate limits for failed login attempts. Authentication works differently with this particular endpoint. You must use Basic Authentication to use this endpoint, where the username is the OAuth application client_id
and the password is its client_secret
. Invalid tokens will return 404 NOT FOUND
.
Path Parameters
The client ID of your GitHub app.
Body
application/json
Body
The access_token of the OAuth application.
Response
application/json
Response
Response
Authorization
The authorization for an OAuth app, GitHub App, or a Personal Access Token.
A list of scopes that this authorization is in.
Show Child Parameters
Simple User
Show Child Parameters
Show Child Parameters
Path Parameters
Body
Reset a token
OAuth applications can use this API method to reset a valid OAuth token without end-user involvement. Applications must save the “token” property in the response because changes take effect immediately. You must use Basic Authentication when accessing this endpoint, using the OAuth application’s client_id
and client_secret
as the username and password. Invalid tokens will return 404 NOT FOUND
.
Path Parameters
The client ID of your GitHub app.
Body
application/json
Body
The access_token of the OAuth application.
Response
application/json
Response
Response
Authorization
The authorization for an OAuth app, GitHub App, or a Personal Access Token.
A list of scopes that this authorization is in.
Show Child Parameters
Simple User
Show Child Parameters
Show Child Parameters
Path Parameters
Body
Delete an app token
OAuth application owners can revoke a single token for an OAuth application. You must use Basic Authentication when accessing this endpoint, using the OAuth application’s client_id
and client_secret
as the username and password.
Path Parameters
The client ID of your GitHub app.
Body
application/json
Body
The OAuth access token used to authenticate to the GitHub API.
Response
Response
Response