List Data Policy Versions
List all versions of a data policy showing the change history. Each version captures the policy state at a point in time for auditability.
Retrieve the version history of a data policy. Each version represents a snapshot of the policy configuration at a point in time. Versions are created automatically when the policy, its fields, or its rules are modified. This endpoint is useful for auditing changes and understanding how the policy evolved.
Version numbers are monotonically increasing integers starting at 1. When a resolution run captures a policy snapshot, it records the version number, allowing you to correlate resolution results with the specific policy configuration that produced them.
GET
/v1/data-policies/{id}/versionsResponse
Response fields
dataarrayArray of version objects.
data[].versionintegerVersion number.
data[].created_atstringISO 8601 timestamp when this version was created.
data[].fields_countintegerNumber of declared fields in this version.
data[].rules_countintegerNumber of rules in this version.
curl
Response
{
"data": [
{ "version": 3, "created_at": "2024-10-15T11:30:00.000Z", "fields_count": 5, "rules_count": 8 },
{ "version": 2, "created_at": "2024-10-10T14:00:00.000Z", "fields_count": 4, "rules_count": 6 },
{ "version": 1, "created_at": "2024-10-01T09:00:00.000Z", "fields_count": 2, "rules_count": 3 }
]
}Errors
Error responses
401unauthorizedMissing or invalid API key.
404not_foundData policy not found or does not belong to your organization.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.