Data Policy

Delete data policy

DELETE/v4/config/consent/policy/{policyId}

Deletes a data policy. The answer is the latest revision of the deleted policy. The data agreements that copied the policy keep their copy.

Delete data policy

Language of the request sample

curl -X DELETE 'https://demo-api.igrant.io/v4/config/consent/policy/6af080a42d6fb7b6ac6efc54' \
  -H 'Authorization: ApiKey <your-api-key>'

{
  "id": "6af080d32d6fb7b6ac6efc56",
  "schemaName": "Policy",
  "objectId": "6af080a42d6fb7b6ac6efc54",
  "signedWithoutObjectId": false,
  "timestamp": "2026-11-08T14:01:55Z",
  "authorizedByIndividualId": "",
  "authorizedByOther": "6ae2bf74a401855d2806ab5d",
  "predecessorHash": "5172776ed742c08df985f58fcbe3afd641c0f862",
  "predecessorSignature": "",
  "objectData": "{\"id\":\"6af080a42d6fb7b6ac6efc54\",\"name\":\"Privacy policy\",\"version\":\"2.0.0\",\"url\":\"https://www.example.com/privacy-policy\",\"jurisdiction\":\"Sweden\",\"industrySector\":\"Retail\",\"dataRetentionPeriodDays\":730,\"geographicRestriction\":\"European Union\",\"storageLocation\":\"Sweden\"}",
  "successorId": "",
  "serializedHash": "1e6da1a43a88ca5e0524e1d0122a6a75ae0f5733",
  "serializedSnapshot": "{\"schemaName\":\"Policy\",\"objectId\":\"6af080a42d6fb7b6ac6efc54\",\"signedWithoutObjectId\":false,\"timestamp\":\"2026-11-08T14:01:55Z\",\"authorizedByIndividualId\":\"\",\"authorizedByOther\":\"6ae2bf74a401855d2806ab5d\",\"objectData\":\"{\\\"id\\\":\\\"6af080a42d6fb7b6ac6efc54\\\",\\\"name\\\":\\\"Privacy policy\\\",\\\"version\\\":\\\"2.0.0\\\",\\\"url\\\":\\\"https://www.example.com/privacy-policy\\\",\\\"jurisdiction\\\":\\\"Sweden\\\",\\\"industrySector\\\":\\\"Retail\\\",\\\"dataRetentionPeriodDays\\\":730,\\\"geographicRestriction\\\":\\\"European Union\\\",\\\"storageLocation\\\":\\\"Sweden\\\"}\",\"organisationId\":\"\"}",
  "organisationId": "6ae2bf741c3dadfeb27982ec"
}

Authorizations

Authorizationstringheaderrequired
Your API key with the prefix ApiKey: ApiKey <your-api-key>. Get an API key.
Scope:data-agreements:delete

Path parameters

policyIdstringrequired
Policy ID.
Example:"6af080a42d6fb7b6ac6efc54"

Response

application/json

The latest revision of the deleted data policy.

idstring
Revision ID. It is empty for a draft data agreement: a draft has no saved revision, so the server builds one for the answer only.
Example:"6af080a42d6fb7b6ac6efc55"
schemaNameenum<string>
Type of the record of this revision.
Available options:DataAgreement,Policy,ConsentRecord,DataDisclosureAgreementTemplate,DataDisclosureAgreementRecord
Example:"Policy"
objectIdstring
ID of the record of this revision.
Example:"6af080a42d6fb7b6ac6efc54"
objectDatastring
The record at this revision, as a JSON string.
signedWithoutObjectIdboolean
true when the server made the hash before the record had an ID.
Example:false
serializedSnapshotstring
The JSON string that the server hashes: the revision fields (schemaName, objectId, timestamp, authorizedByIndividualId, authorizedByOther, objectData and more) without id, successorId, serializedHash and serializedSnapshot.
serializedHashstring
SHA-1 hash of serializedSnapshot, in hexadecimal.
Example:"5172776ed742c08df985f58fcbe3afd641c0f862"
timestampstring<date-time>
Time of the change, in UTC (ISO 8601).
Example:"2026-11-08T14:01:08Z"
authorizedByIndividualIdstring
Not used. Always empty.
authorizedByOtherstring
ID of who made the change: the admin (or the admin of the API key) for a data agreement or a policy, the individual for a consent record.
Example:"6ae2bf74a401855d2806ab5d"
successorIdstring
ID of the next revision of the same record. Empty for the latest revision.
predecessorHashstring
serializedHash of the revision before this one. Empty for the first revision.
predecessorSignaturestring
Not used. Always empty.
organisationIdstring
ID of the organisation that owns the record.
Example:"6ae2bf741c3dadfeb27982ec"