myOneTrustDeveloper ForumTechnology Partners
API Reference
Subscribe via RSS

Delete Purposes from Data Subject

delete
https://{hostname}/api/consentmanager/v2/datasubjects/profiles

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.
Body Params
purposes
array of uuids

The unique identifiers of the purposes.

purposes
dataSubjects
array of uuids

The list of GUIDS for the data subject identifiers.

dataSubjects
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.

identifiers
array of strings

The list of data subject identifiers for the data subjects.

identifiers
Responses

400

Bad Request

401

Unauthorized

403

Forbidden

500

Internal Server Error

Updated 29 days ago

Language
Credentials
OAuth2
Missing 2 required scopes
URL
LoadingLoading…
Response
Choose an example:
application/json
*/*

Updated 29 days ago