---
id: config-delete-policy
title: "Delete data policy"
description: "This endpoint is used to delete an existing data policy."
sidebar_label: "Delete data policy"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "delete api-method"
info_path: docs/consent-management-admin-api/igrant-io-api-documentation
custom_edit_url: null
---

> **Build this with an AI coding agent.** Install the iGrant.io Agent Skills, then ask your agent to build the integration:
>
> ```bash
> npx skills add L3-iGrant/skills
> ```


import ApiTabs from "@theme/ApiTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import Markdown from "@theme/Markdown";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";

<h1 className={"openapi__heading"}>Delete data policy</h1>

<MethodEndpoint method={"delete"} path={"/config/policy/{policyId}"}></MethodEndpoint>



This endpoint is used to delete an existing data policy.

## Request

<details style={{"marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collapsed={false} open={true}><summary style={{}}><h3 className={"openapi-markdown__details-summary-header-params"}>Path Parameters</h3></summary><div><ul><ParamsItem className={"paramsItem"} param={{"description":"Unique ID of an object","in":"path","name":"policyId","required":true,"schema":{"type":"string"}}}></ParamsItem></ul></div></details><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>

Data policy deleted successfully

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"id"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","format":"","example":"65471222e8c7c3bb3c2c6601","description":"Revision ID"}}></SchemaItem><SchemaItem collapsible={false} name={"schemaName"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`dataAgreement`, `policy`, `dataAgreementRecord`]"} schema={{"type":"string","format":"","example":"dataAgreement","description":"Previously \"schema\" but for technical reasons should be called \"schemaName\"","enum":["dataAgreement","policy","dataAgreementRecord"]}}></SchemaItem><SchemaItem collapsible={false} name={"objectId"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","format":"","example":"65471222e8c7c3bb3c2c8492","description":"The PK of the object that was serialised"}}></SchemaItem><SchemaItem collapsible={false} name={"objectData"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","format":"","example":"{...}","description":"The object that is serialised"}}></SchemaItem><SchemaItem collapsible={false} name={"signedWithoutObjectId"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean","format":"","example":false,"description":"Indicates that objectId was left blank in serizalizedSnapshot when calculating serializedHash. objectId may subsequently be filled in."}}></SchemaItem><SchemaItem collapsible={false} name={"serizalizedSnapshot"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","format":"","example":"{...}","description":"Revisioned data (sed as JSON) as a dict. Apply JSON Canonicalization Scheme as per IETF RFC 8785.  It contains all the fields of the schema except sucessorId, serializedHash, serializedSnapshot.\n"}}></SchemaItem><SchemaItem collapsible={false} name={"serializedHash"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","format":"","example":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2","description":"Hash of serizalizedSnapshot (SHA-1)"}}></SchemaItem><SchemaItem collapsible={false} name={"timestamp"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","format":"","example":"2024-01-15T10:30:00Z","description":"Timestamp of when revisioning happened. It should be ISO 8601 UTC date time"}}></SchemaItem><SchemaItem collapsible={false} name={"authorizedByIndividualId"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"description":"Individual ID","type":"string"}}></SchemaItem><SchemaItem collapsible={false} name={"authorizedByOtherId"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","format":"","example":"64541a2e6e7569000145ab00","description":"Reference to an admin user that has created this revision"}}></SchemaItem><SchemaItem collapsible={false} name={"successorId"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"x-fk-model":"Revision","type":"string","description":"If this revision is no longer the latest revision, refer to its successor"}}></SchemaItem><SchemaItem collapsible={false} name={"predecessorHash"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","format":"","example":"b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3","description":"Tamper-resistent artifact from previous record, copied from serializedHash"}}></SchemaItem><SchemaItem collapsible={false} name={"predecessorSignature"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","format":"","example":"c3d4e5f6a1b2...","description":"Tamper-resistent artifact from previous record (we don't know if the previous record was signed or not)"}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"id\": \"65471222e8c7c3bb3c2c6601\",\n  \"schemaName\": \"dataAgreement\",\n  \"objectId\": \"65471222e8c7c3bb3c2c8492\",\n  \"objectData\": \"{...}\",\n  \"signedWithoutObjectId\": false,\n  \"serizalizedSnapshot\": \"{...}\",\n  \"serializedHash\": \"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2\",\n  \"timestamp\": \"2024-01-15T10:30:00Z\",\n  \"authorizedByIndividualId\": \"string\",\n  \"authorizedByOtherId\": \"64541a2e6e7569000145ab00\",\n  \"successorId\": \"string\",\n  \"predecessorHash\": \"b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3\",\n  \"predecessorSignature\": \"c3d4e5f6a1b2...\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"400"} value={"400"}><div>

bad input parameter

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div></div></TabItem><TabItem label={"401"} value={"401"}><div>

Unauthorized

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"404"} value={"404"}><div>

Resource not found

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"500"} value={"500"}><div>

Internal server error

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem></ApiTabs></div></div>