Zur Dokumentation springen
API

Dateien gesammelt löschen

Löscht bis zu 100 Dateien in einem Aufruf, jede so, wie `DELETE /files/{id}` eine löscht, wie beim Auswählen mehrerer Dateien auf der Seite „Dateien“.

POSTapi.openemail.uk/files/batch-delete

Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.

POST /files/batch-delete

Löscht bis zu 100 Dateien in einem Aufruf, jede so, wie DELETE /files/{id} eine löscht, wie beim Auswählen mehrerer Dateien auf der Seite „Dateien“.

Beispiel

Benötigt threads:write. ids nimmt 1 bis 100 Datei-IDs, und jedes andere Feld ist ein 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"]}'
Antwort
{  "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"]}

Ein Aufruf, bei dem manche Dateien gehen und andere bleiben, ist kein Fehler. deleted listet, was gelöscht wurde, kept jede Datei in Gebrauch mit ihrer usage und dem reason in Worten, und missing die IDs, die unbekannt, schon gelöscht oder außerhalb der Adressen eines eingeschränkten Schlüssels sind.

Jede Datei wird beim Löschen erneut geprüft, sodass eine, die nach Ihrer Abfrage in Gebrauch kam, bleibt statt verloren zu gehen. Rückgängig machen geht nicht.