---
title: "Withdraw Data Subject's Consent for All Purposes in a Preference Center"
method: DELETE
path: "/api/consentmanager/v1/preferencecenters/{prefcenterId}/datasubjects/preferences"
tags: ["Preference Centers"]
---

# Withdraw Data Subject's Consent for All Purposes in a Preference Center

`DELETE /api/consentmanager/v1/preferencecenters/{prefcenterId}/datasubjects/preferences`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/consentmanager/v1/preferencecenters/{prefcenterId}/datasubjects/preferences`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `CONSENT`

Use this API to withdraw a data subject's consent for all Purposes within a Preference Center.

> 🗒 Things to Know
> 
> - The Notification Opt-Out Purpose will be excluded when calling this API.

## Path parameters

- `prefcenterId` string, uuid, required

## Query parameters

- `identifier` string

## Headers

- `identifier` string

## Response `200`

OK - Successfully withdrew data subject's consent for all purposes.

- ConsentPreferencesUniversalConsentPreferenceManagDataSubjectPreferencesResponseDto
  - `Purposes` ConsentPreferencesUniversalConsentPreferenceManagDataSubjectPurposesResponseDto[]: List of Purposes with their updated consent status for the Data Subject
    - `messages` string[]: List of status messages related to the Purpose update operation
    - `Id` string, uuid: Unique identifier for the Purpose that was updated
    - `Status` boolean: Indicates whether the Purpose update was successful
    - `ReceiptGuid` string, uuid: Unique identifier for the receipt of this update operation
  - `Language` string: The preferred language of the Data Subject in BCP 47 format

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500`: Internal Server Error

---

[API](https://skmtc.dev/onetrust/apis/consent-preferences-universal-consent-preference-management.md) - [All operations](https://skmtc.dev/onetrust/apis/consent-preferences-universal-consent-preference-management/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/consent-preferences-universal-consent-preference-management/revisions/fe4a0697ec9d?raw)