Publicar un archivo en un enlace público
Crea un enlace de descarga público que abre el archivo sin iniciar sesión, para una imagen o un documento al que se hace referencia desde un correo o una página web.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
POST /files/{id}/links
Crea un enlace de descarga público que abre el archivo sin iniciar sesión, para una imagen o un documento al que se hace referencia desde un correo o una página web.
Ejemplo
Necesita files:write. El cuerpo es opcional. domain indica el dominio cuyo host de archivos sirve el enlace, como acme.com para files.acme.com. La respuesta es un 201 con el nuevo enlace.
curl -X POST "$OE/files/file_6bb640f5b99e47deb758f1f5/links" -H "$AUTH" -H 'content-type: application/json' -d '{ "domain": "acme.com" }'{ "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": 0, "lastDownloadAt": null, "revokedAt": null, "createdAt": "2026-09-24T10:02:17.000Z"}El enlace se sirve en el host de archivos de domain cuando ese dominio tiene uno. Sin él, o cuando ese dominio no tiene ninguno, se sirve en el host de archivos de la dirección a la que pertenece el archivo, y si no, en la dirección de la API.
Un archivo que llegó o salió en un mensaje se copia primero a un almacenamiento público. Un programa o un script se rechaza con un 422 file_unshareable.
Cada llamada crea un enlace nuevo con su propio recuento de descargas, así que un reintento tras perder la respuesta crea un segundo. Lista los enlaces con GET /files/{id}/links antes de volver a intentarlo.
Un enlace sigue funcionando hasta que se revoca o se elimina el archivo.