Révocation - Documentation GitHub

Révocation

Utilisez l’API REST pour révoquer les informations d’identification que vous avez trouvées exposées sur GitHub ou ailleurs.

Revoke a list of credentials

Submit a list of credentials to be revoked. This endpoint is intended to revoke credentials the caller does not own and may have found exposed on GitHub.com or elsewhere. It can also be used for credentials associated with an old user account that you no longer have access to. Credential owners will be notified of the revocation.

This endpoint currently accepts the following credential types:

Personal access tokens (classic)
Fine-grained personal access tokens

Revoked credentials may impact users on GitHub Free, Pro, & Team and GitHub Enterprise Cloud, and GitHub Enterprise Cloud with Enterprise Managed Users. GitHub cannot reactivate any credentials that have been revoked; new credentials will need to be generated.

To prevent abuse, this API is limited to only 60 unauthenticated requests per hour and a max of 1000 tokens per API request.

Note

Any authenticated requests will return a 403.

Jetons d’accès affinés pour « Revoke a list of credentials »

Ce point de terminaison fonctionne avec les types de jetons précis suivants:

Le jeton précis ne nécessite aucune autorisation.

Paramètres pour « Revoke a list of credentials »

En-têtes
Nom, Type, Description
`accept` string Setting to `application/vnd.github+json` is recommended.

Paramètres du corps
Nom, Type, Description
`credentials` array of strings Obligatoire A list of credentials to be revoked, up to 1000 per request.

Codes d’état de la réponse HTTP pour « Revoke a list of credentials »

Code d’état	Description
`202`	Accepted
`422`	Validation failed, or the endpoint has been spammed.
`500`	Internal Error

Exemples de code pour « Revoke a list of credentials »

Exemple de requête

post/credentials/revoke

curl -L \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  https://api.github.com/credentials/revoke \
  -d '{"credentials":["ghp_1234567890abcdef1234567890abcdef12345678","ghp_abcdef1234567890abcdef1234567890abcdef12"]}'

Accepted

Status: 202