🎉 OneTrust 202602.1.0 Released!
We are excited to announce the following enhancements in the OneTrust Developer Portal as part of OneTrust 202602.1.0 (Winter Release).
For more information about the release and our product updates in the OneTrust Platform, refer to the OneTrust Release Notes page. Learn more about environment maintenance on the Current and Historic Maintenance page, and subscribe to proactive environment notifications on our System Status and Scheduled Maintenance page.
Cookie Consent
Existing Public Preview Features
- Bulk Export APIs
The following APIs are now available for use to create and cancel bulk exports and retrieve their status, progress, download details, and credit details. These APIs enable users to extract large volumes of cookie receipts at once with a limit of six bulk exports per month.
Mobile App Consent
New Public Preview Features
-
New Parameters for Get Preference Center Data API
Updated the Get Preference Center Data API response to include thepurposesHeaderandvendorsTypeHeaderparameters within thegeneralobject of thepcUIDataobject of the response to communicate the localized headings configured for the Purposes and Vendors sections to SDKs. This enhancement allows you to mirror the exact mobile and CTV copy that admins set in OneTrust without hardcoding translations, keeping the on-device preference center consistent with the published experience. -
Legitimate Interest Configuration for Reject All for CMP APIs
Leverage therejectAllButtonBehaviorparameter within theappConfigobject of the response when calling the following CMP APIs to configure objection to legitimate interest when rejecting all purposes.This enhancement improves compatibility with Google Limited Ads and feature parity with the CMP platform.
-
New Parameters to Support Layout Specifications
Updated the Get Preference Center Data API response to include thelayoutparameter within thegeneralobject of thepcUIdataobject of the response. This parameter allows you to retrieve information on layout configurations in your CMP. This enhancement also creates parity between the CMP APIs and the admin interface when configuring CMPs for CTV applications. -
Updated Vendor Disclosure Parameters
TheIABTCF_VendorsDisclosedandIABGPP_TCFEU2_VendorsDisclosedparameters within thestorageKeysobject of the following API's responses have been renamed toIABTCF_DisclosedVendorsandIABGPP_TCFEU2_DisclosedVendors, respectively. These changes were made to accurately reflect IAB specifications. Customers that parse these parameters within the response should update their existing integrations to use the new parameter names. -
Enhanced Error Handling for CMP APIs
Updated the following APIs to include thewarningsobject of the response that contains thecodeandmessageparameters. This enhancement adds a warning message in the response when the SDK version does not match the published version and enables the CMP APIs to fall back to the latest published version.
Existing Public Preview Features
- Consent Management Platform APIs
The following APIs are now available for use with retrieving interface attributes needed to display the Banner and Preference Center, retrieving a list of active IAB and Google Vendors to display on the Preference Center, and logging consent when an end user interacts with a Banner or Preference Center. These APIs enable you to easily access data for Banner and Preference Center implementations, disclose vendor information to end users, and capture end user consent.
Third-Party Risk Management
-
New Delete Contract & Delete Engagement APIs
Added the Delete Contract and Delete Engagement APIs to enable external systems and integrations to remove contracts and engagements programmatically. This enhancement allows you to manage the lifecycle of these entities through external integrations while maintaining proper authorization and data integrity. -
Enhanced Contracts & Engagements Data Models
Data models for various Contracts and Engagements APIs have been enhanced to add the following new objects and parameters:- Updated the Create Engagement API to include the
vendorTypeobject containing theid,value, andvalueKeyparameters within thevendorsobject of the request. - Updated the Get Engagement, Create Engagement, Update Engagement, Modify Engagement, and Search Engagements APIs to include the
vendorTypeobject containing theid,value, andvalueKeyparameters within thevendorsobject of the response. - Updated the Search Contracts and Search Engagements APIs to include the
redactedparameter within the response. - Updated the Get Contract Schema and Get Engagement Schema APIs to include the
optionsByDomainandformulaByDomainparameters within the response. - Updated the Get Contract Schema and Get Engagement Schema APIs to include the
optionListUrl,optionType,permissions, andapplicationUrlparameters within theoptionMetadataobject of the response.
These updates enhance Contracts and Engagements APIs with improved vendor type visibility, redaction awareness, and schema metadata that enable more accurate data handling and simplify downstream reporting.
- Updated the Create Engagement API to include the
Universal Consent & Preference Management
General Availability
-
Bulk Edit & Delete Data Subjects
Perform bulk actions on data subjects based on your specified criteria using the newDATA_SUBJECTS_BULK_ACTIONSexport type that is now supported across all Bulk Export APIs. The following parameters were also added to support this new export type:- The
actionTypeparameter was added to the Create Bulk Export API to support the following actions:DELETEused for deleting data subjects andREMOVE_TEST_FLAGused for removing test flags from data subjects used for testing purposes. - The
testDataSubjectparameter was added to the Create Bulk Export API to filter data subjects by the test flag.
With this enhancement, the exported file will now contain the
actionTypevalue that was selected when the Create Bulk Export API was called. You can then review the records within the exported file and import it into the OneTrust Platform using the new Consent data subjects bulk actions import template, enabling you to quickly update large volumes of data subject records.For more information, see Bulk Importing Consent Records.
- The
-
New Create Job API
Added the new Create Job API to create scheduled jobs for completing data subject bulk actions initiated from the Create Bulk Export API, such as deleting data subjects and removing test flags from data subjects used for testing purposes. With this API, you can automate the import of the exported file without having to manually review and import the records.
Fixed
- Resolved an issue that produced errors when valid values were added to the
sortparameter when calling the following V4 APIs: