Create Policy

{
  "data": {
    "policy_name": "customer-support-policy"
  }
}

curl -X PUT https://<domain>/api/vault/metadata/policy/create \
  -H "Authorization: Bearer <NAMESPACE_ADMIN_API_KEY>" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{
    "data": {
      "policy_name": "customer-support-policy"
    }
  }'

{
  "data": {
    "message": "customer-support-policy created successfully."
  },
  "success": true,
  "error": { "message": "" }
}

Creates a new policy in the namespace with default metadata. After creation, update the policy to configure entity categories and masking behavior.

Endpoint

Authentication

Request body

Notes

• Policy names must be unique within the namespace

• If the policy already exists, the API returns an error — use Update Entity Categories to modify existing policies

• All supported entities default to pseudonymizable upon creation

• Use policy_name in Mask and Unmask API calls to apply this policy