This module adds an endpoint for revoking OAuth 2.0 access and refresh tokens previously issued by the Simple OAuth module. It allows clients to invalidate tokens using requests to the `/oauth/revoke` endpoint, ensuring that the client issuing the token is properly authenticated.
This module implements the token revocation endpoint for OAuth 2.0 as outlined by RFC 7009.
After enabling this module, an /oauth/revoke endpoint will be available to
revoke access or refresh tokens previously obtained by the Simple OAuth module.
Revoking a Token
To revoke a token, a POST request can be made to /oauth/revoke.
The body of the request must be in the application/x-www-form-urlencoded format and contain a token parameter set to the token to revoke.
Authorization
The request must be authorized with the client that originally issued the tokens. The client_id and client_secret can be provided in the request body or via Basic authentication.
Alternatively, a bearer token may be used to authorize the request.
Example
curl --location 'https://example.com/oauth/revoke' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'token=<access or refresh token>' \ --data-urlencode 'client_id=<client id>' \ --data-urlencode 'client_secret=<client secret>'
For more details, see the RFC 7009 specification.
Ask your assistant about Simple OAuth Revoke
Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works
Depends on
Dependencies of the latest stable release
Required by
Tracked projects that depend on this one
No tracked projects depend on this one yet.
Activity
Release Timeline
Releases
| Version | Type | Core | PHP | Release date | |
|---|---|---|---|---|---|
| 3.0.0 | Stable | 10–11 | Aug 22, 2025 | ||
| 2.0.0 | Stable | 10 | Jan 18, 2024 | ||
| 2.0.0-alpha2 | Pre-release | 10 | Jun 30, 2023 | ||
| 2.0.0-alpha1 | Pre-release | 10 | Jun 30, 2023 | ||
| 1.0.2 | Stable | 8–10 | Jun 30, 2023 |