---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/disk-api/doc/ru/reference/unpublish-admin-phash.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/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/public/resources/admin/unpublish
? [public_key](*popup-public_key)=<ключ или публичный URL ресурса>
```


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

public_key[*](*popup-a)
: <!-- source: ru/_includes/reference/term-public-key-admin.md -->
  Ключ опубликованного ресурса или публичная ссылка на ресурс.

  Например:

  - короткая ссылка (`https%3A%2F%2Fdisk.yandex.ru%2Fd%2F446d6f44-bb36-48bb-973c-4e1c71e33ccd`);
  - полная ссылка (`https%3A%2F%2Fdisk.yandex.ru%2Fpublic%2F%3Fhash%3DdAEMkc1QDY4SPb5%252BBlFnEKkx1oWX7%2Fp5zYSCvHGQ5%2F6FQeE4ICFyXScld621gdJYq%2FJ6bpmRyOJonT3VoXnDag%253D%253D`);
  - хеш (`dAEMkc1QDY4SPb5%2BBlFnEKkx1oWX7%2Fp5zYSCvHGQ5%2F6FQeE4ICFyXScld621gdJYq%2FJ6bpmRyOJonT3VoXnDag%3D%3D`).

  Значение параметра следует кодировать в URL-формате.
  <!-- endsource: ru/_includes/reference/term-public-key-admin.md -->

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


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

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

где `<token>` — токен администратора организации.


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

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

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

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

```json
{
  "path": "/disk/aa_dir",
  "owner_uid": 1130000066112015
}
```

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

**ResourceUnpublished**

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


#|
|| **Элемент** | **Описание** ||
||`path` | Полный путь к ресурсу на Диске. ||
||`owner_uid` | Идентификатор владельца ресурса.||
|#
<!-- endsource: ru/_includes/reference/response-objects/id-link/resourceunpublished-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` — Некорректный запрос.
* `401` — Не авторизован.
* `403` — API недоступно. Ваши файлы занимают больше места, чем у вас есть. Удалите лишнее или увеличьте объем Диска. / API недоступно. Диск в режиме «только чтение». Проверьте тариф вашей организации.
* `404` — Не удалось найти запрошенный ресурс.
* `423` — Технические работы. Сейчас можно только просматривать и скачивать файлы.
* `423` — Ресурс заблокирован. Возможно, над ним выполняется другая операция.
* `503` — Сервис временно недоступен.

[*popup-public_key]: Ключ опубликованного ресурса или публичная ссылка на ресурс.

Например:

- короткая ссылка (`https%3A%2F%2Fdisk.yandex.ru%2Fd%2F446d6f44-bb36-48bb-973c-4e1c71e33ccd`);
- полная ссылка (`https%3A%2F%2Fdisk.yandex.ru%2Fpublic%2F%3Fhash%3DdAEMkc1QDY4SPb5%252BBlFnEKkx1oWX7%2Fp5zYSCvHGQ5%2F6FQeE4ICFyXScld621gdJYq%2FJ6bpmRyOJonT3VoXnDag%253D%253D`);
- хеш (`dAEMkc1QDY4SPb5%2BBlFnEKkx1oWX7%2Fp5zYSCvHGQ5%2F6FQeE4ICFyXScld621gdJYq%2FJ6bpmRyOJonT3VoXnDag%3D%3D`).

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

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