Для AI-агентов: markdown этой страницы — /docs-content/entities/folders/public-link.md индекс документации — /llms.txt

Публичная ссылка на папку

POST /v1/folders/:id/public-link

Ссылка открывает ВСЁ содержимое папки, включая будущие файлы любому без авторизации. Выключить её через API нельзя: только в интерфейсе Битрикс24 или физическим удалением объекта.

Метод создаёт ссылку, если её нет. Повтор возвращает ту же ссылку. Может вернуться существующая ссылка другого сотрудника, в том числе с паролем или сроком; ответ не сообщает, защищена ли она. Не пишите URL в логи, аудит и телеметрию. Корзина лишь приостанавливает доступ: восстановление снова открывает прежнюю ссылку. Объект в корзине допускается и возвращает meta.inTrash=true; по ссылке будет страница «объект не найден» до восстановления.

Параметры

Параметр	Тип	Обяз.	Описание
id	integer	да	Целое безопасное число больше нуля

Скоуп ключа: disk. Тело не требуется. READONLY-ключ не может публиковать.

curl — личный ключ

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/folders/42/public-link" -H "X-Api-Key: YOUR_API_KEY"

curl — ключ приложения

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/folders/42/public-link" -H "X-Api-Key: YOUR_APP_KEY"

JavaScript — личный ключ

javascript

const response = await fetch("https://vibecode.bitrix24.tech/v1/folders/42/public-link", {
  method: "POST",
  headers: { "X-Api-Key": "YOUR_API_KEY" },
});
const data = await response.json();

JavaScript — ключ приложения

javascript

const response = await fetch("https://vibecode.bitrix24.tech/v1/folders/42/public-link", {
  method: "POST",
  headers: { "X-Api-Key": "YOUR_APP_KEY" },
});
const data = await response.json();

Ответ

JSON

{"success":true,"data":{"url":"https://bitrix24public.com/example.bitrix24.com/folder/EXAMPLE_LINK","revocableViaApi":false},"meta":{"inTrash":false}}

Поля ответа

Поле	Тип	Описание
success	boolean	true
data.url	string	Секретная ссылка доступа
data.revocableViaApi	boolean	false
meta.inTrash	boolean	Объект в корзине

Ограничения и ошибки

У папок нет файлового тарифного гейта. Публикация корня хранилища запрещена: 400 INVALID_PARAMS до вызова Б24, чтобы не открыть весь личный или общий диск.

403 BITRIX_ACCESS_DENIED означает отсутствие права изменения объекта или отключённые публичные ссылки на портале; Б24 не различает причины. 404 ENTITY_NOT_FOUND означает отсутствие объекта. 422 DISK_PUBLIC_LINK_REFUSED означает, что ссылка не получена. Записи автоматически не повторяются: при 502 DISK_OUTCOME_UNKNOWN сначала перечитайте состояние. В batch недоступно.

Для физического удаления используйте purge.

Метод Битрикс24: disk.folder.getExternalLink.

400 — неверный id в пути:

JSON

{"success":false,"error":{"code":"INVALID_ID","message":"id must be a positive safe integer."}}