Rename a device - Talaria Developer Documentation

curl --request PATCH \
  --url "https://directory.example.com/dids/did%3Atalaria%3A1111111111111111111111/devices/mobile-01" \
  --header "Content-Type: application/json" \
  --data '{
    "did": "did:talaria:1111111111111111111111",
    "new_device_id": "mobile-02"
  }'

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

curl --request PATCH \
  --url "https://directory.example.com/dids/did%3Atalaria%3A1111111111111111111111/devices/mobile-01" \
  --header "Content-Type: application/json" \
  --data '{
    "did": "did:talaria:1111111111111111111111",
    "new_device_id": "mobile-02"
  }'

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

A DID can list multiple devices. This endpoint changes a device identifier while keeping it associated with the same public identity. Use it when a client rotates its local device identifier or replaces a provisional name. It does not update encryption keys inside the DID document.

Request

string

required

The DID that owns the device.

string

required

The current device identifier.

string

required

The same DID used in the path.

string

required

The replacement device identifier.

curl --request PATCH \
  --url "https://directory.example.com/dids/did%3Atalaria%3A1111111111111111111111/devices/mobile-01" \
  --header "Content-Type: application/json" \
  --data '{
    "did": "did:talaria:1111111111111111111111",
    "new_device_id": "mobile-02"
  }'

Response

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

Straight to the point

PATCH /dids/{did}/devices/{currentDeviceId}
Content-Type: application/json

{"did":"<same-did>","new_device_id":"<replacement>"}

Accepted: 202
Path/body DID mismatch: 403
Missing current or new identifier: 400

Add a device Remove a device

⌘I

​Request

​Response

​Straight to the point

Request

Response

Straight to the point