View Resource Metadata

Several storage services—such as DID Store, Credential Store, and KMS—support free-form metadata on their child resources. This lets you add tags, descriptions, or other custom details. The /metadata/view endpoint returns the full metadata JSON for a resource so you can review or process it as needed.

View metadata (KMS key example)

CURL

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

Example Request

curl -X 'GET' \
  'https://{orgHost}.enterprise-sandbox.waltid.dev/v1/{target}/kms-service-api/metadata/view' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {yourToken}'

Path Parameters

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

Example Response 200 OK

{
  "description": "Primary signing key for sandbox issuer",
  "tags": [
    "issuing",
    "production"
  ]
}
  • If no metadata exists, the service returns 404 Not Found.
  • Metadata is always a JSON object; structure is completely up to you.
Last updated on December 3, 2025