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

# Revoke Device

> Session/api-key authenticated. Revokes a device, kills its runtime tokens, and disables its public link.

Flips the device to `revoked`, deletes its runtime tokens (so the egress gateway
immediately stops resolving them), and disables its public link (the edge relay
stops routing to it). Scoped to the caller's company. Idempotent — revoking an
already-revoked device returns `200`.

### Path Parameters

| Parameter | Type   | Description   |
| --------- | ------ | ------------- |
| `id`      | string | The device id |

<RequestExample>
  ```bash theme={"theme":"css-variables"}
  curl -X POST https://api.usenaive.ai/v1/devices/dev_01H.../revoke \
    -H "Authorization: Bearer nv_sk_live_..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":"css-variables"}
  { "device_id": "dev_01H...", "status": "revoked", "tokens_killed": 2 }
  ```
</ResponseExample>

<Note>
  Revocation is the kill switch: a revoked device can transact nothing and is
  unreachable over its public link until re-claimed and re-provisioned. See the
  [security model](/docs/self-hosting/security-model).
</Note>