Delete policy

Permanently deletes a policy. This action cannot be undone. Supports both API key authentication (X-API-Key header) and session authentication (cookies + X-Organization-Id header).

DELETE /v1/policies/{id}

Delete policy

cURL

curl --request DELETE \
  --url http://localhost:3333/v1/policies/{id} \
  --header 'X-API-Key: <api-key>'

200

{
  "success": true,
  "deletedPolicy": {
    "id": "pol_abc123def456",
    "name": "Data Privacy Policy"
  }
}

Authentication

✅ Organization User (CustomerEmployee)
❌ Delegated User (EndUser)
✅ Service Account

Required Permissions

Policies:Archive: Always required.

Authorizations

X-API-Key · string · header · required

API key for authentication

Headers

X-Organization-Id · string

Organization ID (required for session auth, optional for API key auth)

Path Parameters

id · string · required

Policy ID

Example:

"pol_abc123def456"

Response

200

application/json

Policy deleted successfully

success · boolean

Indicates successful deletion

Example:

true

deletedPolicy · object

Show child attributes

authType · enum<string>

How the request was authenticated

Available options: api-key, session