Set Resource Metadata

Use /metadata/set to replace the complete metadata object associated with a stored resource. This is handy when you want to initialize metadata for a KMS key, DID, or credential or when you want to overwrite all metadata fields in one go.

Set metadata (KMS key example)

CURL

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

Example Request

curl -X 'PUT' \
  'https://{orgHost}.enterprise-sandbox.waltid.dev/v1/{target}/kms-service-api/metadata/set' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {yourToken}' \
  -H 'Content-Type: application/json' \
  -d '{
    "description": "Primary signing key for sandbox issuer",
    "tags": ["issuing", "production"]
  }'

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 replace, e.g. test.tenant1.kms-eu.key-auth.

Body

{
  "description": "Primary signing key for sandbox issuer",
  "tags": [
    "issuing",
    "production"
  ]
}

Body Parameters

  • metadata: JSON object - Arbitrary key/value pairs describing the resource. Send {} to clear all fields in a single step.

Response Codes

  • 200 – Metadata stored successfully.
  • 400 – Malformed JSON payload.
  • 401/403 – Authentication or authorization failure.
Last updated on December 3, 2025
View Resource MetadataUpdate Resource Metadata (JSON Patch)