문서로 건너뛰기
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입니다.