OneTrust is excited to announce that we are in the process of migrating all APIs in the OneTrust Developer Portal from Swagger 2.0 to the OpenAPI 3.1.0 specification. Please see the details below as this change will impact your experience with the product.
Impacted OneTrust Product(s): All Public APIs on the OneTrust Developer Portal
Target Audience: OneTrust Developer Community
What is changing?
We are migrating all APIs in the OneTrust Developer Portal from Swagger 2.0 to the OpenAPI 3.1.0 specification. During this transition, you may encounter a mix of Swagger 2.0 and OpenAPI 3.1.0 specifications depending on the API you are accessing. You can determine whether an API is using Swagger 2.0 or OpenAPI 3.1.0 by clicking the Download icon next to the API summary and reviewing the link at the bottom of the popover.
When is this taking place?
This migration is currently in progress and not yet complete across all APIs. During this transition, you may encounter a mix of Swagger 2.0 and OpenAPI 3.1.0 specifications depending on the API you are accessing.
Why is this occurring?
OpenAPI 3.1.0 offers enhanced compatibility with JSON Schema, improved support for third-party integrations, and greater flexibility for describing modern API architectures, enabling a more robust and future-ready developer experience.
Action required
If your applications currently read, parse, or interact with Swagger 2.0 specifications, you must update your tooling and processes. Swagger 2.0 parsers will not be compatible with OpenAPI 3.1.0, and continued use may result in integration failures once the migration is complete.