Revoke User OAuth Scope Consent

PATCH {{apiPath}}/environments/{{envID}}/users/{{userID}}/oauthConsents/{{oauthConsentID}}

The PATCH /environments/{{envID}}/users/{{userID}}/oauthConsents/{{oauthConsentID}} operation gives the actor the ability to revoke an OAuth scope consent for the specified user. This operation uses the application/vnd.pingidentity.consent.revoke+json custom content type in the request header.

Prerequisites

For property descriptions, see OAuth scope consent data model.

PropertyTypeRequired?
statusStringRequired

Request Body

{"status"=>"REVOKED"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring

RESPONSES

status: OK

{"_links":{"self":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/01dee5b5-48fa-4a6b-a574-f2ff28ab5b32/oauthConsents/663a3fae-b0fa-4da3-a9ae-f2d60aebe56c"},"environment":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"user":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/01dee5b5-48fa-4a6b-a574-f2ff28ab5b32"}},"id":"663a3fae-b0fa-4da3-a9ae-f2d60aebe56c","application":{"id":"a4f6b7ed-95be-4dde-b5b5-dde152625b75"},"applicationName":"externalApp1","applicationType":"EXTERNAL","environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"user":{"id":"01dee5b5-48fa-4a6b-a574-f2ff28ab5b32"},"scope":["openid"],"status":"REVOKED","consentedAt":"2022-08-24T22:31:45.573Z","updatedAt":"2022-08-24T22:33:13.805Z"}