> Markdown version of https://authpi.com/docs/reference/idp-api/consent-management/ — fetch the complete AuthPI docs index at https://authpi.com/llms.txt to discover all available pages.

# Consent Management — AuthPI Identity Provider API

## 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

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `issuer_id` | string | Required | The unique identifier for the issuer/tenant |
| `client_id` | string | Required | The client whose consent grants should be revoked |

### Responses

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