URL:  /api/v2/script_folders/:folder_id

Method: PATCH

Пареметры запроса:Описание

{

"folder_id": string

}


folder_id - идентификатор редактируемой папки.

Пареметры тела запроса:


{

"name": string,
"description": string,
"parent" : string,
"visibility": string,


}

description - новое описание сценария, опционально. Если не указано, то наименование сценария изменено не будет.

parent (FolderId) - идентификатор новой родительской папки для сценария, опционально. Если не указан, то расположение сценария изменено не будет.

  • name-  новое наименование папки, опционально, в случае отсутствия параметра наименование не будет изменено.
  • description - новое описание папки, опционально, в случае отсутствия параметра описание не будет изменено.
  • parent - идентификатор новой родительской папки, опционально, в случае отсутствия параметра расположение не будет изменено.
  • visibility - новый параметр видимости папки, опционально, в случае отсутствия параметра видимость папки не будет изменена.


ОтветыОписание

204 

No Content: папка успешно удалена; папки не существует.
400Bad request - некорректная структура запроса.
401Unauthorized - текущий пользователь не авторизован.
403

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

404

Not Found: сценарий с указанным идентификатором не найден; папка с указанным идентификатором не найдена (если он указан).

409

Conflict: сценарий с данным именем уже существует в данной папке.

  • Нет меток