Перейти к документации
API

Удалить файлы пакетом

Удаляет до 100 файлов за один вызов, каждый так же, как `DELETE /files/{id}` удаляет один, как при выборе нескольких файлов на странице «Файлы».

POSTapi.openemail.uk/files/batch-delete

Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.

POST /files/batch-delete

Удаляет до 100 файлов за один вызов, каждый так же, как DELETE /files/{id} удаляет один, как при выборе нескольких файлов на странице «Файлы».

Пример

Нужен threads:write. ids принимает от 1 до 100 id файлов, а любое другое поле даёт 422 unknown_parameter.

curl
curl -X POST "$OE/files/batch-delete" -H "$AUTH" -H 'content-type: application/json' -d '{  "ids": ["file_0c4e7a91d2b84f63a5e19b7d", "file_6bb640f5b99e47deb758f1f5", "file_9e2b41c7a0f35d8e6b1c4a72"]}'
Ответ
{  "object": "file_batch_delete",  "deleted": ["file_0c4e7a91d2b84f63a5e19b7d"],  "kept": [    {      "id": "file_6bb640f5b99e47deb758f1f5",      "filename": "invoice-0912.pdf",      "usage": "received",      "reason": "It came in on a message, so it stays with that message."    }  ],  "missing": ["file_9e2b41c7a0f35d8e6b1c4a72"]}

Вызов, в котором одни файлы удаляются, а другие остаются, это не ошибка. deleted перечисляет удалённое, kept каждый используемый файл с его usage и reason словами, а missing id, которые неизвестны, уже удалены или лежат за пределами адресов ограниченного ключа.

Каждый файл проверяется заново в момент удаления, поэтому файл, который начал использоваться после того, как вы получили список, остаётся, а не теряется. Отменить нельзя.