Set primary alias - Mintlify Starter Kit

curl --request PUT \
  --url "https://directory.example.com/dids/did%3Atalaria%3A1111111111111111111111/alias" \
  --header "Content-Type: application/json" \
  --data '{
  "did": "did:talaria:1111111111111111111111",
  "alias": "river.stone"
}'

{
  "status": "accepted",
  "did": "did:talaria:1111111111111111111111",
  "extrinsic": "set_alias",
  "tx_hash": "<transaction-hash>",
  "message": "Chain extrinsic submitted"
}

curl --request PUT \
  --url "https://directory.example.com/dids/did%3Atalaria%3A1111111111111111111111/alias" \
  --header "Content-Type: application/json" \
  --data '{
  "did": "did:talaria:1111111111111111111111",
  "alias": "river.stone"
}'

{
  "status": "accepted",
  "did": "did:talaria:1111111111111111111111",
  "extrinsic": "set_alias",
  "tx_hash": "<transaction-hash>",
  "message": "Chain extrinsic submitted"
}

Set the primary public alias for a DID.

Request

did

string

required

The DID to update.

did

string

required

The DID to update. It must match the path.

alias

string

required

The new primary alias.

curl --request PUT \
  --url "https://directory.example.com/dids/did%3Atalaria%3A1111111111111111111111/alias" \
  --header "Content-Type: application/json" \
  --data '{
  "did": "did:talaria:1111111111111111111111",
  "alias": "river.stone"
}'

Response

status

string

required

The submission status.

did

string

required

The DID affected by the request.

extrinsic

string

required

The public operation name.

tx_hash

string

required

The submitted transaction hash.

message

string

required

A human-readable submission result.

{
  "status": "accepted",
  "did": "did:talaria:1111111111111111111111",
  "extrinsic": "set_alias",
  "tx_hash": "<transaction-hash>",
  "message": "Chain extrinsic submitted"
}

202 Accepted means the Directory accepted the request for processing. It does not confirm final settlement.

⌘I

​Request

​Response

Request

Response