#Purge Resource Metadata

/metadata/purge removes the metadata block attached to a stored resource. This is useful when you want to reset tags and descriptions entirely, or before re-initializing metadata with fresh context.

#Purge metadata (KMS key example)

CURL

Endpoint: /v1/{target}/kms-service-api/metadata/purge | API Reference

Example Request

curl -X 'DELETE' \
  'https://{orgHost}.enterprise-sandbox.waltid.dev/v1/{target}/kms-service-api/metadata/purge' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {yourToken}'

Path Parameters

orgHost: String - Organization host alias to call against. In sandbox, test maps to https://test.enterprise-sandbox.waltid.dev.
target: resourceIdentifier - Full path to the KMS key (or other resource) whose metadata you want to delete, e.g. test.tenant1.kms-eu.key-auth.

Response Codes

200 – Metadata purged successfully.
404 – No metadata existed for that resource.
401/403 – Authentication or authorization failure.

Last updated on December 3, 2025

Update Resource Metadata (JSON Patch)Query Resources by Metadata