---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.0
alternate:
  - https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/platform-delete.md
  - https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/platform-delete.md
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/platform-delete.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/en/llms.txt?revision=r21995741
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/smart-home/doc/en/llms.txt?revision=r21995741

# Delete device

Deletes the user's device.

## Request format {#input}

```
DELETE https://api.iot.yandex.net/v1.0/devices/{[device_id](*device_id)}
```

#|
||
device_id
|
ID of the user device.
||
|#


<!-- source: en/_includes/concepts/platform-capabilities/header-section.md -->
#### Request headers {#header-section}

#|
||**Header** | **Description** | **Required**||
||Authorization | The authorization token of the OAuth application. | Yes||
|#
<!-- endsource: en/_includes/concepts/platform-capabilities/header-section.md -->



## Response format {#output-structure}


{% list tabs %}

- Response successful


  ```json translate=no
  HTTP/1.1 200 OK

  {
      "[request_id](*row-request-id)": String,
      "[status](*row-status-struct-table-protocol-alerts)": "ok"
  }
  ```

  <!-- source: en/_includes/reference-alerts/struct-table-protocol-alerts/id-struct-table-protocol-alerts/post-skill_id-callback-state-response.md -->
  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  |
  **Required**
  ||

  ||
  request_id
  |
  [String](*string)
  |
  Request ID. Must be logged for the purpose of incident investigation.
  |
  Yes
  ||

  ||
  status
  |
  [String](*string)
  |
  Status of processing the request. Acceptable values:
  - `ok`.
  |
  Yes
  ||
  |#
  <!-- endsource: en/_includes/reference-alerts/struct-table-protocol-alerts/id-struct-table-protocol-alerts/post-skill_id-callback-state-response.md -->



- Response with error


  ```json translate=no
  HTTP/1.1 404 Not Found

  {
      "[request_id](*row-request-id)": String,
      "[status](*row-error-status-struct-table-protocol-alerts)": "error",
      "[message](*row-message)": String
  }
  ```

  <!-- source: en/_includes/concepts/platform-capabilities/id-output-structure/table-error.md -->
    #|
    ||
    **Parameter**
    |
    **Type**
    |
    **Description**
    |
    **Required**
    ||

    ||
    request_id
    |
    [String](*string)
    |
    Request ID. Must be logged for the purpose of incident investigation.
    |
    Yes
    ||

    ||
    status
    |
    [String](*string)
    |
    Status of processing the request. Acceptable values:
    - `error`.

    |
    Yes
    ||

    ||
    message
    |
    [String](*string)
    |
    Error message.
    |
    No
    ||
    |#
  <!-- endsource: en/_includes/concepts/platform-capabilities/id-output-structure/table-error.md -->


  [Error codes](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/platform-error-codes.md)

{% endlist %}


## Example {#example-JSON}

> {% list tabs %}
>
> - Request
>
>
>   ```bash translate=no
>   curl -i -X DELETE 'https://api.iot.yandex.net/v1.0/devices/device-id-1' \
>   -H 'Authorization: Bearer 123qwe456a...'
>   ```
>
>
> - Response successful
>
>
>   ```json translate=no
>   HTTP/1.1 200 OK
>
>   {
>       "[request_id](*row-request-id)": "667b3e0f-47a8-4136-9211-b4ff59062315",
>       "[status](*row-status-struct-table-protocol-alerts)": "ok"
>   }
>   ```
>
>
> - Response with error
>
>
>   ```json translate=no
>   HTTP/1.1 404 Not Found
>
>   {
>       "[request_id](*row-request-id)": "667b3e0f-47a8-4136-9211-b4ff59062315",
>       "[status](*row-error-status-struct-table-protocol-alerts)": "error",
>       "[message](*row-message)": "Устройство не найдено"
>   }
>   ```
>
> {% endlist %}


<!-- {% include [support-support-button](../_includes/about/id-support/support-button.md) %}-->

[*string]:
  String enclosed in quotation marks, for example: `"Hello, world"`.

[*device_id]: Идентификатор устройства пользователя.

[*row-request-id]:
  **Type**

[String](https://yandex.ru/dev/dialogs/smart-home/doc/en/types.md#string)

**Description**

Request ID. Must be logged for the purpose of incident investigation.

**Required**

Yes

[*row-status-struct-table-protocol-alerts]:
  **Type**

[String](*string)

**Description**

Status of processing the request. Acceptable values:
  - `ok`.


**Required**

Yes

[*row-error-status-struct-table-protocol-alerts]:
  **Type**

[String](*string)

**Description**

Status of processing the request. Acceptable values:
  - `error`.


**Required**

Yes

[*row-message]:
   **Type**

[String](*string)

**Description**

Error message.

**Required**

No