Revoke an access token
Learn about revoking a previously issued access token.
Use this API to revoke a previously issued access token.
Request
POST /oauth/revoke?token={token}
Response
The API returns a JSON object. If the tenant uses SAML SSO and a logout endpoint is configured, the response includes an additional field: logoutUri
.
Field | Type | Description |
---|---|---|
status | string | Indicates the result of the revoke request. Returns success when the token has been revoked. |
logoutUri | string (optional) | Present only when the tenant is configured with SAML logout. Redirects the user's browser to this URL to complete Single Logout (SLO) and clear the IdP session. |
Example for a standard tenant:
{
"status": "success"
}
Example for a SAML SSO tenant with logout configured:
{
"status": "success",
"logoutUri": "https://{your-cognito-domain}/logout?client_id={clientId}&logout_uri=https://login.reltio.com/success?id=logout"
}