> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talaria.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Remove a device

> Permanently remove a device entry from a public Talaria DID record

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](/api-reference/directory/dids/tombstone-device) instead.

## Request

<ParamField path="did" type="string" required>
  The DID that owns the device.
</ParamField>

<ParamField path="deviceId" type="string" required>
  The device identifier to remove.
</ParamField>

The request has no body.

<RequestExample>
  ```bash Request theme={null}
  curl --request DELETE \
    --url "https://directory.example.com/dids/did%3Atalaria%3A1111111111111111111111/devices/mobile-01"
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 202 Response theme={null}
  {
    "status": "accepted",
    "did": "did:talaria:1111111111111111111111",
    "extrinsic": "remove_device",
    "tx_hash": "<transaction-hash>",
    "message": "Chain extrinsic submitted"
  }
  ```
</ResponseExample>

<Note>
  `202` confirms submission, not final chain settlement.
</Note>

## Straight to the point

```http theme={null}
DELETE /dids/{did}/devices/{deviceId}
```

* Body: none
* Operation: `remove_device`
* Accepted: `202`