---
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/ru/concepts/platform-delete.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741

# Удаление устройства

<!-- source: ru/_includes/reusables/neuroexpert-button.md -->



<!-- endsource: ru/_includes/reusables/neuroexpert-button.md -->


Удаляет устройство пользователя.

## Формат запроса {#input}

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

#|
||
device_id
|
Идентификатор устройства пользователя.
||
|#


<!-- source: ru/_includes/concepts/platform-capabilities/header-section.md -->
#### Заголовки запроса {#header-section}

#|
||**Заголовок** | **Описание** | **Обязательный**||
||Authorization | Авторизационный токен oauth-приложения. | Да||
|#
<!-- endsource: ru/_includes/concepts/platform-capabilities/header-section.md -->



## Формат ответа {#output-structure}


{% list tabs %}

- Успешный ответ


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

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

  <!-- source: ru/_includes/reference-alerts/struct-table-protocol-alerts/id-struct-table-protocol-alerts/post-skill_id-callback-state-response.md -->
  #|
  ||
  **Параметр**
  |
  **Тип**
  |
  **Описание**
  |
  **Обязательный**
  ||

  ||
  request_id
  |
  [String](*string)
  |
  Идентификатор запроса. Необходимо логировать для расследования инцидентов.
  |
  Да
  ||

  ||
  status
  |
  [String](*string)
  |
  Статус обработки запроса. Допустимые значения:
  - `ok`.
  |
  Да
  ||
  |#
  <!-- endsource: ru/_includes/reference-alerts/struct-table-protocol-alerts/id-struct-table-protocol-alerts/post-skill_id-callback-state-response.md -->



- Ответ с ошибкой


  ```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: ru/_includes/concepts/platform-capabilities/id-output-structure/table-error.md -->
    #|
    ||
    **Параметр**
    |
    **Тип**
    |
    **Описание**
    |
    **Обязательный**
    ||

    ||
    request_id
    |
    [String](*string)
    |
    Идентификатор запроса. Необходимо логировать для расследования инцидентов.
    |
    Да
    ||

    ||
    status
    |
    [String](*string)
    |
    Статус обработки запроса. Допустимые значения:
    - `error`.

    |
    Да
    ||

    ||
    message
    |
    [String](*string)
    |
    Сообщение об ошибке.
    |
    Нет
    ||
    |#
  <!-- endsource: ru/_includes/concepts/platform-capabilities/id-output-structure/table-error.md -->


  [Коды ошибок](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/platform-error-codes.md)

{% endlist %}


## Пример {#example-JSON}

> {% list tabs %}
>
> - Запрос
>
>
>   ```bash translate=no
>   curl -i -X DELETE 'https://api.iot.yandex.net/v1.0/devices/device-id-1' \
>   -H 'Authorization: Bearer 123qwe456a...'
>   ```
>
>
> - Успешный ответ
>
>
>   ```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"
>   }
>   ```
>
>
> - Ответ с ошибкой
>
>
>   ```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 %}


<!-- source: ru/_includes/about/id-support/support-button.md -->
[![Служба поддержки](../_images/support-image.svg)](https://yandex.ru/dev/dialogs/smart-home/doc/ru/feedback.md)
<!-- endsource: ru/_includes/about/id-support/support-button.md -->

[*string]:
  Cтрока, выделяется кавычками, например `"Hello world"`.

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

[*row-request-id]:
  **Тип**

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

**Описание**

Идентификатор запроса. Необходимо логировать для расследования инцидентов.

**Обязательный**

Да

[*row-status-struct-table-protocol-alerts]:
  **Тип**

[String](*string)

**Описание**

Статус обработки запроса. Допустимые значения:
  - `ok`.


**Обязательный**

Да

[*row-error-status-struct-table-protocol-alerts]:
  **Тип**

[String](*string)

**Описание**

Статус обработки запроса. Допустимые значения:
  - `error`.


**Обязательный**

Да

[*row-message]:
   **Тип**

[String](*string)

**Описание**

Сообщение об ошибке.

**Обязательный**

Нет