API

Revogar uma ligação pública

Faz com que uma ligação de transferência deixe de funcionar, para sempre, incluindo no correio que já saiu com ela.

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

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

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

Faz com que uma ligação de transferência deixe de funcionar, para sempre, incluindo no correio que já saiu com ela.

Exemplo

Precisa de files:write. A resposta é a ligação, com revokedAt preenchido.

curl

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

Resposta

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

Revogar uma ligação já revogada responde com ela inalterada, por isso a chamada pode ser repetida com segurança. Uma ligação desconhecida é um 404 not_found.