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

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.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)