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

# Восстановление файла или папки из Корзины

Перемещенный в Корзину ресурс можно восстановить на прежнем месте, указав путь к нему в корзине. Восстанавливаемый ресурс при этом можно переименовать.

Если восстанавливаемый файл находился внутри папки, которая отсутствует на момент запроса, эта папка будет создана на прежнем месте. Например, если на Диске ничего нет, и вы восстанавливаете файл, который находился в папке `/foo/bar/`, будут созданы папки `foo` и `bar`.


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

Запрос восстановления следует отправлять с помощью метода PUT.
```
https://cloud-api.yandex.net/v1/disk/trash/resources/restore
 ? [path](*popup-path)=<путь к восстанавливаемому ресурсу>
 & [[name](*popup-name)=<новое имя для восстанавливаемого ресурса>]
 & [[overwrite](*popup-overwrite)=<признак перезаписи>]
```

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

path[*](*popup-a)
: Путь к восстанавливаемому ресурсу относительно корневого каталога корзины. Например, `%2Fbar%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 -->


name
: Новое имя восстанавливаемого ресурса. Например, `selfie.png`.

overwrite
: Признак перезаписи. Учитывается, если ресурс восстанавливается в папку, в которой уже есть ресурс с таким именем.

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

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


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

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

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

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

Восстановление ресурса из Корзины может занять неопределенное время. В зависимости от статуса операции, сервер Яндекс Диска возвращает один из двух вариантов ответа:

- Если к моменту ответа запрос удалось обработать без ошибок, API отвечает кодом `201 Created` (ресурс успешно перемещен), и возвращает ссылку на мета-информацию о созданном ресурсе в теле ответа, в объекте [Link](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#link).

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

    ```json
    {
    "href": "https://cloud-api.yandex.net/v1/disk/resources?path=disk%3A%2Fbar%2Fselfie.png",
    "method": "GET",
    "templated": false
    }
    ```

- <!-- source: ru/_includes/reference/public/id-save/asynch-202.md -->
  Если операция сохранения была запущена, но еще не завершилась, Яндекс Диск отвечает кодом `202 Accepted`.
  <!-- endsource: ru/_includes/reference/public/id-save/asynch-202.md -->

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

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

    ```json
    {
    "href": "https://cloud-api.yandex.net/v1/disk/resources?path=disk%3A%2F%D0%97%D0%B0%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B8%photo.png",
    "method": "GET",
    "templated": false
    }
    ```

    {% include [link-table](../_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 -->

[*popup-path]: Путь к восстанавливаемому ресурсу относительно корневого каталога корзины. Например, `%2Fbar%2Fphoto.png`.


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

[*popup-name]: Новое имя восстанавливаемого ресурса. Например, `selfie.png`.

[*popup-overwrite]: Признак перезаписи. Учитывается, если ресурс восстанавливается в папку, в которой уже есть ресурс с таким именем.

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

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

[*popup-a]: Обязательный параметр.
{% included (../_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 может быть запрошен без изменений.||
|#

{% endincluded %}