Sample - Box Platform API
POST/oauth2/revoke

Revoke access token

Revoke an active Access Token, effectively logging a user out that has been previously authenticated.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

3 body fields
client_idstringoptional
The Client ID of the application requesting to revoke the access token.
client_secretstringoptional
The client secret of the application requesting to revoke an access token.
tokenstringoptional
The access token to revoke.

3 status codes
200Returns an empty response when the token was successfully revoked.
400An authentication error.
errorstringoptional
The type of the error returned.
error_descriptionstringoptional
The type of the error returned.
defaultAn authentication error.
errorstringoptional
The type of the error returned.
error_descriptionstringoptional
The type of the error returned.

Error handling

A 400 is returned: An authentication error. Any other status is an error: An authentication error.