---
title: "Delete Purpose from Data Subjects"
method: DELETE
path: "/api/consent/v2/datasubject-purposes/{purposeGuid}"
tags: ["Data Subjects V2"]
---

# Delete Purpose from Data Subjects

`DELETE /api/consent/v2/datasubject-purposes/{purposeGuid}`

Use this API for large scale deletion of a specific purpose from all data subjects.

> 🗒 Things to Know
> 
> - A data subject exclusion list is required to provide the specific data subjects from which the purpose should not be deleted. The **Consent DS Exclusion** import template within Global Settings in the OneTrust Platform can be used to create the data subject exclusion list and can be imported via Bulk Import in the application or via API.
> - Once the data subject exclusion list has been successfully imported, either an `importID` or `jobGuid` parameter value must be specified in the request body.
> - Data subject exclusion lists are valid during the next 30 days after submission.
> - To override the data subject exclusion list requirement, set the `deletePurposeFromAllDataSubjects` parameter value to `true`. By default, this parameter is set to `false`.
> - By default, related data subject transactions will be removed from the database and will no longer appear in the OneTrust Platform UI after calling this API. However, the transactions can still be retrieved using the [Get List of Receipts API](https://developer.onetrust.com/onetrust/reference/getreceiptlistdetailsusingpost). To maintain data subject transactions in the database and OneTrust Platform UI, set the `retainTransactions` parameter to `true`.

## Path parameters

- `purposeGuid` string, uuid, required

## Request body

- ConsentAPIDeleteDataSubjectByPurposeRequest
  - `jobGuid` string, uuid — The UUID of the data exclusion job.
  - `importId` string — The import ID of the data exclusion job.
  - `retainTransactions` boolean — This flag indicates whether transactions will be retained while deleting purposes from data subjects. When set to `false`, transactions are removed from the database and no longer appear in the OneTrust Platform UI. However, these transactions are not permanently deleted and can still be retrieved using the [Get List of Receipts API](https://developer.onetrust.com/onetrust/reference/getreceiptlistdetailsusingpost).
  - `deletePurposeFromAllDataSubjects` boolean — This flag indicates whether the purpose should be deleted from all data subjects.

## Response `202`

Purpose deletion from Data Subjects request processed successfully.

- string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `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)