Sign in
Dids

Track an externally-managed DID

Registers a reference to an externally-managed DID for local tracking. Only the DID string (and optional alias) is persisted; the resolver fetches the document and the IDK CacheService holds it. The tracked DID always gets role = EXTERNAL. KMS key material is never bound to external DIDs; keys belong to MANAGED DIDs created locally via POST /identifiers.

post/identifiers/external

Parameters

./common-components.yml#/components/parameters/CorrelationId — unresolved $ref

Request body

didstring required

The external DID string to track.

aliasstring

Optional human-readable alias.

Example request

{
  "did": "did:web:enterprise.example.com",
  "alias": "rest-tracked"
}

Response

External DID reference created successfully.

Did required— unresolved $ref

Changes