URL: http://Host.port/api/v2/script_folders

Method: POST

ИмяОписаниеПример

FolderCreateDescription


Параметры создаваемой папки



"name": string,

название папки

"name":"s",


"description": string,

описание папки

"description":"",


"parent": string,

id родительской папки(00000000 - корень)

"parent":"00000000",


"visibility": Visibility

видимость папки:

  • visible - виден
  • hidden - скрыт

"visibility":"visible"

HTTP-заголовки ответа

Описание

Location="/api/v2/script_folders/{folder_id}"

folder_id – ID созданной папки.

Ответы

201 

Сreated, путь до созданной папки в заголовке ответа Location: /api/v2/script_folders/:folder_id - папка создана успешно.
303See other, путь до существующей папки в заголовке ответа Location: /api/v2/script_folders/:folder_id -  по заданным параметрам в области (в корне или внутри папки, заданной в parent) уже есть папка с таким наименованием.
400Bad request - некорректная структура запроса.
401Unauthorized - текущий пользователь не авторизован.
403

Forbidden - текущему пользователю запрещено создавать конкретно такую папку (например, есть скрытая с таким
  наименованием, но он её видеть не должен. Вообще не должен о ней ничего знать) или пользователь пытается создать скрытую папку.

404Not Found - родительская папка не найдена (если её идентификатор отличен от нулевого).
409Conflict - создаваемая папка уже существует
500Internal Server Error - внутренняя ошибка сервера
  • Нет меток