v1

latestOpenAPI 3.1.0Apache 2.02026-07-245981,1853.0 MB

Data Subjects V2

Delete Purposes from Data Subject

Use this API to delete up to 100 purposes from one data subject or to delete one purpose from up to 100 data subjects.

🗒 Things to Know

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. To maintain data subject transactions in the database and OneTrust Platform UI, set the retainTransactions parameter to true.

delete/api/consentmanager/v2/datasubjects/profiles

Request body

purposesstring[]

The unique identifiers of the purposes.

dataSubjectsstring[]

The list of GUIDS for the data subject identifiers.

retainTransactionsboolean

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.

identifiersstring[]

The list of data subject identifiers for the data subjects.

Example request

{
  "purposes": [
    "550e8400-e29b-41d4-a716-446655440000"
  ],
  "dataSubjects": [
    "a9adf402-adcd-45be-b981-a56a5c0739ec"
  ],
  "identifiers": [
    "user@example.com"
  ]
}

Response

OK - Successfully processed deletion of purposes from data subjects.

string required