Zur Dokumentation springen
API

Einen öffentlichen Link widerrufen

Legt einen Download-Link endgültig still, auch in Mails, die bereits mit ihm verschickt wurden.

DELETEapi.openemail.uk/files/{id}/links/{linkId}

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

DELETE /files/{id}/links/{linkId}

Legt einen Download-Link endgültig still, auch in Mails, die bereits mit ihm verschickt wurden.

Beispiel

Benötigt files:write. Die Antwort ist der Link, mit gesetztem revokedAt.

curl
curl -X DELETE "$OE/files/file_6bb640f5b99e47deb758f1f5/links/fshr_4d7a0c2e9b16f3584a2c7e90" -H "$AUTH"
Antwort
{  "object": "file_link",  "id": "fshr_4d7a0c2e9b16f3584a2c7e90",  "fileId": "file_6bb640f5b99e47deb758f1f5",  "filename": "invoice-0912.pdf",  "mimeType": "application/pdf",  "sizeBytes": 184233,  "host": "files.acme.com",  "url": "https://files.acme.com/f/8c2e…/invoice-0912.pdf",  "downloads": 4,  "lastDownloadAt": "2026-09-24T11:40:52.000Z",  "revokedAt": "2026-09-24T12:00:03.000Z",  "createdAt": "2026-09-24T10:02:17.000Z"}

Einen bereits widerrufenen Link zu widerrufen liefert ihn unverändert zurück, der Aufruf lässt sich also gefahrlos wiederholen. Ein unbekannter Link ist ein 404 not_found.