03.07.2026 19:45

Edit

[POST] …/v1/file/edit

Изменяет метаданные файла.

Входные параметры

Название Тип данных Обязательность Описание
id Int64 Обязательный ID файла
name String Необязательный Новое имя файла
access_level FileAccessLevelEnum Необязательный Новый уровень доступа
folder_id Int64 Необязательный Новая папка файла
width Int32 Необязательный Ширина визуального файла в пикселях. Передаётся вместе с height
height Int32 Необязательный Высота визуального файла в пикселях. Передаётся вместе с width
duration_ms Int64 Необязательный Длительность audio/video файла в миллисекундах

Примечания:

  • Для folder_id проверяются существование папки, признак удаления и право записи.
  • width и height передаются только парой и должны быть больше 0.
  • duration_ms не может быть отрицательным.

Пример запроса

{
  "id": 101,
  "name": "photo.jpg",
  "access_level": "public",
  "folder_id": 12,
  "width": 1280,
  "height": 720,
  "duration_ms": null
}

Выходные параметры

Название Тип данных Описание
row_affected Int64 Количество изменённых строк
ids Array ID фактически изменённых записей. Для данного метода не возвращается

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

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": null
  }
}