Esta versão do GitHub Enterprise foi descontinuada em 2022-06-03. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.
Aplicativos OAuth
Sobre a API do aplicativo OAuth
Você pode usar esta API para gerenciar os tokens do OAuth, que um aplicativo OAuth usa para acessar as contas das pessoas em your GitHub Enterprise Server instance.
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.
Parâmetros
| Headers | 
|---|
| Nome, Tipo, Descrição | 
| acceptstringSetting to  | 
| Path parameters | 
| Nome, Tipo, Descrição | 
| client_idstringObrigatórioThe client ID of the GitHub app. | 
| Body parameters | 
| Nome, Tipo, Descrição | 
| access_tokenstringObrigatórioThe OAuth access token used to authenticate to the GitHub API. | 
HTTP response status codes
| Status code | Descrição | 
|---|---|
| 204 | No Content | 
| 422 | Validation failed | 
Amostras de código
curl \
  -X DELETE \
  -H "Accept: application/vnd.github.v3+json" \ 
  -H "Authorization: token <TOKEN>" \
  http(s)://HOSTNAME/api/v3/applications/Iv1.8a61f9b3a7aba766/grant \
  -d '{"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a"}'Response
Status: 204Revoke a grant for an application
Deprecation 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.
Parâmetros
| Headers | 
|---|
| Nome, Tipo, Descrição | 
| acceptstringSetting to  | 
| Path parameters | 
| Nome, Tipo, Descrição | 
| client_idstringObrigatórioThe client ID of the GitHub app. | 
| access_tokenstringObrigatório | 
HTTP response status codes
| Status code | Descrição | 
|---|---|
| 204 | No Content | 
Amostras de código
curl \
  -X DELETE \
  -H "Accept: application/vnd.github.v3+json" \ 
  -H "Authorization: token <TOKEN>" \
  http(s)://HOSTNAME/api/v3/applications/Iv1.8a61f9b3a7aba766/grants/ACCESS_TOKENResponse
Status: 204Check 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.
Parâmetros
| Headers | 
|---|
| Nome, Tipo, Descrição | 
| acceptstringSetting to  | 
| Path parameters | 
| Nome, Tipo, Descrição | 
| client_idstringObrigatórioThe client ID of the GitHub app. | 
| Body parameters | 
| Nome, Tipo, Descrição | 
| access_tokenstringObrigatórioThe access_token of the OAuth application. | 
HTTP response status codes
| Status code | Descrição | 
|---|---|
| 200 | OK | 
| 404 | Resource not found | 
| 422 | Validation failed | 
Amostras de código
curl \
  -X POST \
  -H "Accept: application/vnd.github.v3+json" \ 
  -H "Authorization: token <TOKEN>" \
  http(s)://HOSTNAME/api/v3/applications/Iv1.8a61f9b3a7aba766/token \
  -d '{"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a"}'Response
Status: 200{
  "id": 1,
  "url": "https://api.github.com/authorizations/1",
  "scopes": [
    "public_repo",
    "user"
  ],
  "token": "ghu_16C7e42F292c6912E7710c838347Ae178B4a",
  "token_last_eight": "Ae178B4a",
  "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
  "app": {
    "url": "http://my-github-app.com",
    "name": "my github app",
    "client_id": "abcde12345fghij67890"
  },
  "note": "optional note",
  "note_url": "http://optional/note/url",
  "updated_at": "2011-09-06T20:39:23Z",
  "created_at": "2011-09-06T17:26:27Z",
  "fingerprint": "jklmnop12345678",
  "expires_at": "2011-09-08T17:26:27Z",
  "user": {
    "login": "octocat",
    "id": 1,
    "node_id": "MDQ6VXNlcjE=",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://api.github.com/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://api.github.com/users/octocat/followers",
    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
    "organizations_url": "https://api.github.com/users/octocat/orgs",
    "repos_url": "https://api.github.com/users/octocat/repos",
    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
    "received_events_url": "https://api.github.com/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  }
}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.
Parâmetros
| Headers | 
|---|
| Nome, Tipo, Descrição | 
| acceptstringSetting to  | 
| Path parameters | 
| Nome, Tipo, Descrição | 
| client_idstringObrigatórioThe client ID of the GitHub app. | 
| Body parameters | 
| Nome, Tipo, Descrição | 
| access_tokenstringObrigatórioThe access_token of the OAuth application. | 
HTTP response status codes
| Status code | Descrição | 
|---|---|
| 200 | OK | 
| 422 | Validation failed | 
Amostras de código
curl \
  -X PATCH \
  -H "Accept: application/vnd.github.v3+json" \ 
  -H "Authorization: token <TOKEN>" \
  http(s)://HOSTNAME/api/v3/applications/Iv1.8a61f9b3a7aba766/token \
  -d '{"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a"}'Response
Status: 200{
  "id": 1,
  "url": "https://api.github.com/authorizations/1",
  "scopes": [
    "public_repo",
    "user"
  ],
  "token": "ghu_16C7e42F292c6912E7710c838347Ae178B4a",
  "token_last_eight": "Ae178B4a",
  "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
  "app": {
    "url": "http://my-github-app.com",
    "name": "my github app",
    "client_id": "abcde12345fghij67890"
  },
  "note": "optional note",
  "note_url": "http://optional/note/url",
  "updated_at": "2011-09-06T20:39:23Z",
  "created_at": "2011-09-06T17:26:27Z",
  "fingerprint": "jklmnop12345678",
  "expires_at": "2011-09-08T17:26:27Z",
  "user": {
    "login": "octocat",
    "id": 1,
    "node_id": "MDQ6VXNlcjE=",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://api.github.com/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://api.github.com/users/octocat/followers",
    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
    "organizations_url": "https://api.github.com/users/octocat/orgs",
    "repos_url": "https://api.github.com/users/octocat/repos",
    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
    "received_events_url": "https://api.github.com/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  }
}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.
Parâmetros
| Headers | 
|---|
| Nome, Tipo, Descrição | 
| acceptstringSetting to  | 
| Path parameters | 
| Nome, Tipo, Descrição | 
| client_idstringObrigatórioThe client ID of the GitHub app. | 
| Body parameters | 
| Nome, Tipo, Descrição | 
| access_tokenstringObrigatórioThe OAuth access token used to authenticate to the GitHub API. | 
HTTP response status codes
| Status code | Descrição | 
|---|---|
| 204 | No Content | 
| 422 | Validation failed | 
Amostras de código
curl \
  -X DELETE \
  -H "Accept: application/vnd.github.v3+json" \ 
  -H "Authorization: token <TOKEN>" \
  http(s)://HOSTNAME/api/v3/applications/Iv1.8a61f9b3a7aba766/token \
  -d '{"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a"}'Response
Status: 204Create a scoped access token
Use a non-scoped user-to-server OAuth access token to create a repository scoped and/or permission scoped user-to-server OAuth access token. You can specify which repositories the token can access and which permissions are granted to the token. 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.
Parâmetros
| Headers | |||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Nome, Tipo, Descrição | |||||||||||||||||||||||||||||||||||
| acceptstringSetting to  | |||||||||||||||||||||||||||||||||||
| Path parameters | |||||||||||||||||||||||||||||||||||
| Nome, Tipo, Descrição | |||||||||||||||||||||||||||||||||||
| client_idstringObrigatórioThe client ID of the GitHub app. | |||||||||||||||||||||||||||||||||||
| Body parameters | |||||||||||||||||||||||||||||||||||
| Nome, Tipo, Descrição | |||||||||||||||||||||||||||||||||||
| access_tokenstringObrigatórioThe OAuth access token used to authenticate to the GitHub API. | |||||||||||||||||||||||||||||||||||
| targetstringThe name of the user or organization to scope the user-to-server access token to. Required unless  | |||||||||||||||||||||||||||||||||||
| target_idintegerThe ID of the user or organization to scope the user-to-server access token to. Required unless  | |||||||||||||||||||||||||||||||||||
| repositoriesarray of stringsThe list of repository names to scope the user-to-server access token to.  | |||||||||||||||||||||||||||||||||||
| repository_idsarray of integersThe list of repository IDs to scope the user-to-server access token to.  | |||||||||||||||||||||||||||||||||||
| permissionsobjectThe permissions granted to the user-to-server access token. | |||||||||||||||||||||||||||||||||||
| Properties of the | |||||||||||||||||||||||||||||||||||
| Nome, Tipo, Descrição | 
|---|
| actionsstringThe level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts. Pode ser uma das ações a seguir:  | 
| administrationstringThe level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation. Pode ser uma das ações a seguir:  | 
| checksstringThe level of permission to grant the access token for checks on code. Pode ser uma das ações a seguir:  | 
| contentsstringThe level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges. Pode ser uma das ações a seguir:  | 
| deploymentsstringThe level of permission to grant the access token for deployments and deployment statuses. Pode ser uma das ações a seguir:  | 
| environmentsstringThe level of permission to grant the access token for managing repository environments. Pode ser uma das ações a seguir:  | 
| issuesstringThe level of permission to grant the access token for issues and related comments, assignees, labels, and milestones. Pode ser uma das ações a seguir:  | 
| metadatastringThe level of permission to grant the access token to search repositories, list collaborators, and access repository metadata. Pode ser uma das ações a seguir:  | 
| packagesstringThe level of permission to grant the access token for packages published to GitHub Packages. Pode ser uma das ações a seguir:  | 
| pagesstringThe level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds. Pode ser uma das ações a seguir:  | 
| pull_requestsstringThe level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges. Pode ser uma das ações a seguir:  | 
| repository_hooksstringThe level of permission to grant the access token to manage the post-receive hooks for a repository. Pode ser uma das ações a seguir:  | 
| repository_projectsstringThe level of permission to grant the access token to manage repository projects, columns, and cards. Pode ser uma das ações a seguir:  | 
| secret_scanning_alertsstringThe level of permission to grant the access token to view and manage secret scanning alerts. Pode ser uma das ações a seguir:  | 
| secretsstringThe level of permission to grant the access token to manage repository secrets. Pode ser uma das ações a seguir:  | 
| security_eventsstringThe level of permission to grant the access token to view and manage security events like code scanning alerts. Pode ser uma das ações a seguir:  | 
| single_filestringThe level of permission to grant the access token to manage just a single file. Pode ser uma das ações a seguir:  | 
| statusesstringThe level of permission to grant the access token for commit statuses. Pode ser uma das ações a seguir:  | 
| vulnerability_alertsstringThe level of permission to grant the access token to manage Dependabot alerts. Pode ser uma das ações a seguir:  | 
| workflowsstringThe level of permission to grant the access token to update GitHub Actions workflow files. Pode ser uma das ações a seguir:  | 
| membersstringThe level of permission to grant the access token for organization teams and members. Pode ser uma das ações a seguir:  | 
| organization_administrationstringThe level of permission to grant the access token to manage access to an organization. Pode ser uma das ações a seguir:  | 
| organization_hooksstringThe level of permission to grant the access token to manage the post-receive hooks for an organization. Pode ser uma das ações a seguir:  | 
| organization_planstringThe level of permission to grant the access token for viewing an organization's plan. Pode ser uma das ações a seguir:  | 
| organization_projectsstringThe level of permission to grant the access token to manage organization projects and projects beta (where available). Pode ser uma das ações a seguir:  | 
| organization_packagesstringThe level of permission to grant the access token for organization packages published to GitHub Packages. Pode ser uma das ações a seguir:  | 
| organization_secretsstringThe level of permission to grant the access token to manage organization secrets. Pode ser uma das ações a seguir:  | 
| organization_self_hosted_runnersstringThe level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization. Pode ser uma das ações a seguir:  | 
| organization_user_blockingstringThe level of permission to grant the access token to view and manage users blocked by the organization. Pode ser uma das ações a seguir:  | 
| team_discussionsstringThe level of permission to grant the access token to manage team discussions and related comments. Pode ser uma das ações a seguir:  | 
| content_referencesstringThe level of permission to grant the access token for notification of content references and creation content attachments. Pode ser uma das ações a seguir:  | 
HTTP response status codes
| Status code | Descrição | 
|---|---|
| 200 | OK | 
| 401 | Requires authentication | 
| 403 | Forbidden | 
| 404 | Resource not found | 
| 422 | Validation failed | 
Amostras de código
curl \
  -X POST \
  -H "Accept: application/vnd.github.v3+json" \ 
  -H "Authorization: token <TOKEN>" \
  http(s)://HOSTNAME/api/v3/applications/Iv1.8a61f9b3a7aba766/token/scoped \
  -d '{"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a","target":"octocat","permissions":{"metadata":"read","issues":"write","contents":"read"}}'Response
Status: 200{
  "id": 1,
  "url": "https://api.github.com/authorizations/1",
  "scopes": [],
  "token": "ghu_16C7e42F292c6912E7710c838347Ae178B4a",
  "token_last_eight": "Ae178B4a",
  "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
  "app": {
    "url": "http://my-github-app.com",
    "name": "my github app",
    "client_id": "abcde12345fghij67890"
  },
  "note": "optional note",
  "note_url": "http://optional/note/url",
  "updated_at": "2011-09-06T20:39:23Z",
  "created_at": "2011-09-06T17:26:27Z",
  "fingerprint": "jklmnop12345678",
  "expires_at": "2011-09-08T17:26:27Z",
  "user": {
    "login": "octocat",
    "id": 1,
    "node_id": "MDQ6VXNlcjE=",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://api.github.com/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://api.github.com/users/octocat/followers",
    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
    "organizations_url": "https://api.github.com/users/octocat/orgs",
    "repos_url": "https://api.github.com/users/octocat/repos",
    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
    "received_events_url": "https://api.github.com/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  },
  "installation": {
    "permissions": {
      "metadata": "read",
      "issues": "write",
      "contents": "read"
    },
    "repository_selection": "selected",
    "single_file_name": ".github/workflow.yml",
    "repositories_url": "https://api.github.com/user/repos",
    "account": {
      "login": "octocat",
      "id": 1,
      "node_id": "MDQ6VXNlcjE=",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "gravatar_id": "",
      "url": "https://api.github.com/users/octocat",
      "html_url": "https://github.com/octocat",
      "followers_url": "https://api.github.com/users/octocat/followers",
      "following_url": "https://api.github.com/users/octocat/following{/other_user}",
      "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
      "organizations_url": "https://api.github.com/users/octocat/orgs",
      "repos_url": "https://api.github.com/users/octocat/repos",
      "events_url": "https://api.github.com/users/octocat/events{/privacy}",
      "received_events_url": "https://api.github.com/users/octocat/received_events",
      "type": "User",
      "site_admin": false
    },
    "has_multiple_single_files": false,
    "single_file_paths": []
  }
}Check an authorization
Deprecation 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 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 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.
Parâmetros
| Headers | 
|---|
| Nome, Tipo, Descrição | 
| acceptstringSetting to  | 
| Path parameters | 
| Nome, Tipo, Descrição | 
| client_idstringObrigatórioThe client ID of the GitHub app. | 
| access_tokenstringObrigatório | 
HTTP response status codes
| Status code | Descrição | 
|---|---|
| 200 | OK | 
| 404 | Resource not found | 
Amostras de código
curl \
  -H "Accept: application/vnd.github.v3+json" \ 
  -H "Authorization: token <TOKEN>" \
  http(s)://HOSTNAME/api/v3/applications/Iv1.8a61f9b3a7aba766/tokens/ACCESS_TOKENResponse
Status: 200{
  "id": 1,
  "url": "https://api.github.com/authorizations/1",
  "scopes": [
    "public_repo",
    "user"
  ],
  "token": "ghu_16C7e42F292c6912E7710c838347Ae178B4a",
  "token_last_eight": "Ae178B4a",
  "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
  "app": {
    "url": "http://my-github-app.com",
    "name": "my github app",
    "client_id": "abcde12345fghij67890"
  },
  "note": "optional note",
  "note_url": "http://optional/note/url",
  "updated_at": "2011-09-06T20:39:23Z",
  "created_at": "2011-09-06T17:26:27Z",
  "fingerprint": "jklmnop12345678",
  "expires_at": "2011-09-08T17:26:27Z",
  "user": {
    "login": "octocat",
    "id": 1,
    "node_id": "MDQ6VXNlcjE=",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://api.github.com/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://api.github.com/users/octocat/followers",
    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
    "organizations_url": "https://api.github.com/users/octocat/orgs",
    "repos_url": "https://api.github.com/users/octocat/repos",
    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
    "received_events_url": "https://api.github.com/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  }
}Reset an authorization
Deprecation 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 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.
Parâmetros
| Headers | 
|---|
| Nome, Tipo, Descrição | 
| acceptstringSetting to  | 
| Path parameters | 
| Nome, Tipo, Descrição | 
| client_idstringObrigatórioThe client ID of the GitHub app. | 
| access_tokenstringObrigatório | 
HTTP response status codes
| Status code | Descrição | 
|---|---|
| 200 | OK | 
Amostras de código
curl \
  -X POST \
  -H "Accept: application/vnd.github.v3+json" \ 
  -H "Authorization: token <TOKEN>" \
  http(s)://HOSTNAME/api/v3/applications/Iv1.8a61f9b3a7aba766/tokens/ACCESS_TOKENResponse
Status: 200{
  "id": 1,
  "url": "https://api.github.com/authorizations/1",
  "scopes": [
    "public_repo",
    "user"
  ],
  "token": "ghu_16C7e42F292c6912E7710c838347Ae178B4a",
  "token_last_eight": "Ae178B4a",
  "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
  "app": {
    "url": "http://my-github-app.com",
    "name": "my github app",
    "client_id": "abcde12345fghij67890"
  },
  "note": "optional note",
  "note_url": "http://optional/note/url",
  "updated_at": "2011-09-06T20:39:23Z",
  "created_at": "2011-09-06T17:26:27Z",
  "fingerprint": "jklmnop12345678",
  "expires_at": "2011-09-08T17:26:27Z",
  "user": {
    "login": "octocat",
    "id": 1,
    "node_id": "MDQ6VXNlcjE=",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://api.github.com/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://api.github.com/users/octocat/followers",
    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
    "organizations_url": "https://api.github.com/users/octocat/orgs",
    "repos_url": "https://api.github.com/users/octocat/repos",
    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
    "received_events_url": "https://api.github.com/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  }
}Revoke an authorization for an application
Deprecation 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 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.
Parâmetros
| Headers | 
|---|
| Nome, Tipo, Descrição | 
| acceptstringSetting to  | 
| Path parameters | 
| Nome, Tipo, Descrição | 
| client_idstringObrigatórioThe client ID of the GitHub app. | 
| access_tokenstringObrigatório | 
HTTP response status codes
| Status code | Descrição | 
|---|---|
| 204 | No Content | 
Amostras de código
curl \
  -X DELETE \
  -H "Accept: application/vnd.github.v3+json" \ 
  -H "Authorization: token <TOKEN>" \
  http(s)://HOSTNAME/api/v3/applications/Iv1.8a61f9b3a7aba766/tokens/ACCESS_TOKENResponse
Status: 204