Saltar para a documentação
API

Eliminar ficheiros em massa

Elimina até 100 ficheiros numa só chamada, cada um como `DELETE /files/{id}` elimina um, tal como selecionar vários na página Ficheiros.

POSTapi.openemail.uk/files/batch-delete

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

POST /files/batch-delete

Elimina até 100 ficheiros numa só chamada, cada um como DELETE /files/{id} elimina um, tal como selecionar vários na página Ficheiros.

Exemplo

Precisa de threads:write. ids aceita de 1 a 100 ids de ficheiros, e qualquer outro campo é um 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"]}'
Resposta
{  "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"]}

Uma chamada em que alguns ficheiros saem e outros ficam não é um erro. deleted lista o que saiu, kept cada ficheiro em uso com o seu usage e o reason por extenso, e missing os ids desconhecidos, já eliminados ou fora dos endereços que uma chave limitada tem.

Cada ficheiro é verificado de novo no momento em que é eliminado, por isso um que passou a estar em uso depois de o listar é mantido em vez de perdido. Não há como desfazer.