Unify and manage your data

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.

Table 1. Response fields
FieldTypeDescription
statusstringIndicates the result of the revoke request. Returns success when the token has been revoked.
logoutUristring (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"
}