IdP API Reference

Consent Management — IdP API

Base URL: https://idp.authpi.com — see the IdP API overview for the supported flows, or try these endpoints in the interactive reference.

DELETE/{issuer_id}/consents/{client_id}

Revoke Consent

Revokes the authenticated user's consent grants for the specified client.

After revocation, the user will be prompted for consent again on the next authorization request from this client.

Authorization

Requires a valid access token issued by the same issuer. The user is identified from the token's sub claim.

Path parameters

NameTypeRequiredDescription
issuer_idstringRequiredThe unique identifier for the issuer/tenant
client_idstringRequiredThe client whose consent grants should be revoked

Responses

CodeDescriptionSchema
200Success - Consent revoked (or no active consent existed).object
400Bad Request - The request is malformed or missing required parameters.OAuthError
401Unauthorized - Authentication is required or has failed.OAuthError
403Forbidden - The authenticated client or user lacks permission for this operation.OAuthError
404Not Found - The requested resource does not exist.OAuthError
422Unprocessable Entity - The request syntax is correct but the data cannot be processed.OAuthError
429Too Many Requests - Rate limit exceeded.OAuthError
500Internal Server Error - An unexpected error occurred.OAuthError