---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/disk-api/doc/en/reference/delete.md
  - https://yandex.ru/dev/disk-api/doc/ru/reference/delete.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/disk-api/doc/ru/llms.txt

# Удаление файла или папки

Удалять файлы и папки на Диске пользователя можно, указывая путь к удаляемому ресурсу. Помните, что перемещение ресурсов в корзину никак не влияет на доступное место на Диске. Чтобы освободить место, следует также [удалять ресурсы из корзины](https://yandex.ru/dev/disk-api/doc/ru/reference/trash-delete.md).


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

Метод: ##DELETE##.

```
https://cloud-api.yandex.net/v1/disk/resources
 ? [path](*popup-path)=<путь к удаляемому ресурсу>
 & [[permanently](*popup-permanently)=<признак безвозвратного удаления>]
 & [[md5](*popup-md5)=<MD5 удаляемого файла>]
 & [[force_async](*popup-force_async)=<признак асинхронного выполнения операции>]
 & [[fields](*popup-fields)=<свойства, которые нужно включить в ответ>]

```

### Описание query-параметров {#query}

path[*](*popup-a)
: Путь к удаляемому ресурсу. Например, `$2Ffoo%2Fphoto.png`.

<!-- source: ru/_includes/reference/parameters-warehouse/id-format/path-encoding.md -->
Путь в значении параметра следует кодировать в URL-формате.
<!-- endsource: ru/_includes/reference/parameters-warehouse/id-format/path-encoding.md -->


permanently
: Признак безвозвратного удаления. Поддерживаемые значения:

- `false` — удаляемый файл или папка перемещаются в Корзину (используется по умолчанию).
- `true` — файл или папка удаляются без помещения в Корзину.


md5
: MD5-хеш удаляемого файла. Используется для дополнительной проверки того, что удаляется именно тот файл, который был предназначен для удаления.

MD5-хеш для файла можно получить из ответа на запрос, который возвращает метаинформации о ресурсе.


force_async
: Параметр указывает на возможность асинхронного выполнения операции.

Допустимые значения:

- `false` — операция не является асинхронной: следующий запрос можно отправлять только тогда, когда выполнен предыдущий.
- `true` — асинхронная операция: следующий запрос можно отправлять, не дожидаясь выполнения предыдущего.


fields
: Список свойств JSON, которые следует включить в ответ. Ключи, не указанные в этом списке, будут отброшены при составлении ответа. Если параметр не указан, ответ возвращается полностью, без сокращений.

Имена ключей следует указывать через запятую, а вложенные ключи разделять точками. Например: `name,_embedded.items.path`.


\* Обязательный параметр.


### Заголовок {#header}

```
Authorization: OAuth <token>
```

## Формат ответа {#response}

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

<!-- source: ru/_includes/reference/copy/id-response/response-intro.md -->
Если запрос был обработан без ошибок, API составляет тело ответа в зависимости от вида указанного ресурса — ответ для пустой папки или файла отличается от ответа для непустой папки. 
<!-- endsource: ru/_includes/reference/copy/id-response/response-intro.md -->

#### Файл или пустая папка {#file}

API отвечает кодом `204 No content` (ресурс успешно удален) без тела ответа.

#### Непустая папка {#folder}

Непустая папка может удаляться в течение произвольного времени, поэтому API отвечает кодом `202 Accepted` (удаление папки начато).

<!-- source: ru/_includes/reference/copy/id-response/asynch-explain.md -->
Приложения должны самостоятельно следить за [статусами запрошенных операций](https://yandex.ru/dev/disk-api/doc/ru/reference/operations.md). API возвращает ссылку на статус запущенной по запросу операции в теле ответа в объекте [Link](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#link).
<!-- endsource: ru/_includes/reference/copy/id-response/asynch-explain.md -->

Пример ответа:

```json
{
  "href": "https://cloud-api.yandex.net/v1/disk/operations?id=d80c269ce4eb16c0207f0a15t4a31415313452f9e950cd9576f36b1146ee0e42",
  "method": "GET",
  "templated": false
}
```

#### Описание элементов ответа

<!-- source: ru/_includes/reference/response-objects/id-link/link-table.md -->


#|
|| **Элемент** | **Описание**||
|| `href` | URL. Может быть шаблонизирован, см. ключ `templated`. ||
|| `method` | HTTP-метод для запроса URL из ключа `href`. ||
|| `templated` | Признак URL, который был шаблонизирован согласно [RFC 6570](http://tools.ietf.org/html/rfc6570). Возможные значения:

- «true» — URL шаблонизирован: прежде чем отправлять запрос на этот адрес, следует указать нужные значения параметров вместо значений в фигурных скобках.
- «false» — URL может быть запрошен без изменений.||
|#
<!-- endsource: ru/_includes/reference/response-objects/id-link/link-table.md -->

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

<!-- source: ru/_includes/reference/response-error.md -->
Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит [описание ошибки](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#error).
<!-- endsource: ru/_includes/reference/response-error.md -->

Некоторые возможные ошибки:

* `400` — Проверка md5 возможна только для файлов.
* `401` — Не авторизован.
* `403` — Недостаточно прав для изменения данных в общей папке.
* `404` — Не удалось найти запрошенный ресурс.
* `406` — Ресурс не может быть представлен в запрошенном формате.
* `423` — Технические работы. Сейчас можно только просматривать и скачивать файлы.
* `429` — Слишком много запросов.
* `503` — Сервис временно недоступен.

[*popup-path]: Путь к удаляемому ресурсу. Например, `$2Ffoo%2Fphoto.png`.


Путь в значении параметра следует кодировать в URL-формате.

[*popup-permanently]: Признак безвозвратного удаления. Поддерживаемые значения:

- `false` — удаляемый файл или папка перемещаются в Корзину (используется по умолчанию).
- `true` — файл или папка удаляются без помещения в Корзину.

[*popup-md5]: MD5-хеш удаляемого файла. Используется для дополнительной проверки того, что удаляется именно тот файл, который был предназначен для удаления.

MD5-хеш для файла можно получить из ответа на запрос, который возвращает метаинформации о ресурсе.

[*popup-force_async]: Параметр указывает на возможность асинхронного выполнения операции.

Допустимые значения:

- `false` — операция не является асинхронной: следующий запрос можно отправлять только тогда, когда выполнен предыдущий.
- `true` — асинхронная операция: следующий запрос можно отправлять, не дожидаясь выполнения предыдущего.

[*popup-fields]: Список свойств JSON, которые следует включить в ответ. Ключи, не указанные в этом списке, будут отброшены при составлении ответа. Если параметр не указан, ответ возвращается полностью, без сокращений.

Имена ключей следует указывать через запятую, а вложенные ключи разделять точками. Например: `name,_embedded.items.path`.

[*popup-a]: Обязательный параметр.