Remove a device - Talaria Developer Documentation

curl --request DELETE \
  --url "https://directory.example.com/dids/did%3Atalaria%3A1111111111111111111111/devices/mobile-01"

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

curl --request DELETE \
  --url "https://directory.example.com/dids/did%3Atalaria%3A1111111111111111111111/devices/mobile-01"

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

Removing and tombstoning are different operations.

Remove deletes the device entry from the active device list.
Tombstone preserves a public record that the device was retired.

Use removal only when you intentionally want the runtime’s remove_device operation. If other clients need to recognize a retired or compromised device, use Tombstone a device instead.

Request

string

required

The DID that owns the device.

string

required

The device identifier to remove.

The request has no body.

curl --request DELETE \
  --url "https://directory.example.com/dids/did%3Atalaria%3A1111111111111111111111/devices/mobile-01"

Response

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

202 confirms submission, not final chain settlement.

Straight to the point

DELETE /dids/{did}/devices/{deviceId}

Body: none
Operation: remove_device
Accepted: 202

Rename a device Tombstone a device

⌘I

​Request

​Response

​Straight to the point

Request

Response

Straight to the point