API

公開リンクを取り消す

ダウンロードリンクを完全に無効にする。そのリンク付きですでに送られたメールの中のリンクも無効になる。

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

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

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

ダウンロードリンクを完全に無効にする。そのリンク付きですでに送られたメールの中のリンクも無効になる。

例

files:write が必要。応答は revokedAt が設定されたリンク。

curl

curl -X DELETE "$OE/files/file_6bb640f5b99e47deb758f1f5/links/fshr_4d7a0c2e9b16f3584a2c7e90" -H "$AUTH"

レスポンス

{  "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"}

すでに取り消されたリンクを取り消すと、そのリンクが変更されずに返るので、呼び出しは何度繰り返しても安全である。存在しないリンクは 404 not_found になる。