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

# Закрытие публичного доступа

Метод закрывает общий и персональный доступ к ресурсу по ранее созданной ссылке. Метод удаляет атрибуты `public_key` и `public_url` ресурса, публичные ссылки на него перестают работать.

{% note warning %}

Закрыть доступ к ресурсу можно только с OAuth-токеном его владельца.

{% endnote %}

Необходимые права доступа для OAuth-приложения:
* `cloud_api:disk.read`
* `cloud_api:disk.write`
* `cloud_api:disk.app_folder`


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

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

```
https://cloud-api.yandex.net/v1/disk/resources/unpublish
 ? [path](*popup-path)=<путь к закрываемому ресурсу>
```

### Описание 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 -->


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


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

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

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

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

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

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

```json
{
  "href": "https://cloud-api.yandex.net/v1/disk/resources?path=disk%3A%2Fbar%2Fphoto.png",
  "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.com/dev/disk-api/doc/ru/reference/response-objects.md#error).
<!-- endsource: ru/_includes/reference/response-error.md -->

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

* `400` — Некорректный запрос.
* `401` — Не авторизован.
* `403` — API недоступно. Ваши файлы занимают больше места, чем у вас есть. Удалите лишнее или увеличьте объем Диска. / API недоступно. Диск в режиме «только чтение». Проверьте тариф вашей организации.
* `404` — Не удалось найти запрошенный ресурс.
* `423` — Технические работы. Сейчас можно только просматривать и скачивать файлы.
* `423` — Ресурс заблокирован. Возможно, над ним выполняется другая операция.
* `503` — Сервис временно недоступен.

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


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

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