About
Below is a log of changes to the Persona API. Updates that affect only products or features in beta or limited release may not be reflected.
Each change can be described as either a breaking change or an ongoing change.
- Breaking changes = new API version: When we make any backwards-incompatible changes, we release a new version of the API. In addition to being assigned a new API version, these changes are marked in the changelog with the 💥 symbol. You’re in charge of when you get breaking changes—you get them when you upgrade your API version. Learn how to try out and upgrade to newer API versions.
- Ongoing changes: Ongoing changes are backwards-compatible, and are added on an ongoing basis. You don’t need to update your API version to get these updates.
Key
🌱 New feature
🍃 Improvement
🔧 Fix
💥 Breaking change
🔒 Security-related
Reports
- 🍃 Add position topics, start dates, and end dates to Politically Exposed Person Reports: The
positionsattribute in Politically Exposed Person Reports now exposes position topics as well as the start and end dates indicating the duration each position was held. See the Retrieve a Report endpoint for details.
Events
- 🍃 Add
contextattribute to Events and Webhook Events: Events and Webhook Event resources now include acontextattribute that can hold additional information for certain event types. To start, theaccount.added-relationandaccount.removed-relationevents will haverelation-schema-keyandtarget-account-idattributes withincontext.

