Aller à la documentation
API

Révoquer un lien public

Désactive définitivement un lien de téléchargement, y compris dans les messages déjà partis avec.

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

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

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

Désactive définitivement un lien de téléchargement, y compris dans les messages déjà partis avec.

Exemple

Nécessite files:write. La réponse est le lien, avec revokedAt renseigné.

curl
curl -X DELETE "$OE/files/file_6bb640f5b99e47deb758f1f5/links/fshr_4d7a0c2e9b16f3584a2c7e90" -H "$AUTH"
Réponse
{  "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"}

Révoquer un lien déjà révoqué le renvoie inchangé : l'appel peut donc être répété sans risque. Un lien inconnu donne un 404 not_found.