Créer un transfert

Requête exemple

"{\"files\":[{\"name\":\"contrat-q3.pdf\",\"size\":482133,\"mime_type\":\"application/pdf\"},{\"name\":\"annexe.xlsx\",\"size\":91204,\"mime_type\":\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\"}],\"transfer_title\":\"Dossier client Q3\",\"expires_in_hours\":72,\"max_downloads\":5,\"password\":\"Soleil-2026\",\"recipient\":\"client@exemple.fr\",\"notify_opens\":true,\"allow_download\":true,\"auto_delete\":true,\"require_totp\":false}"

Réponse exemple

"{\"transfer\":{\"id\":\"a3f1c9e2-7b4d-4e88-9c12-0f6b2a1d5e90\",\"short_code\":\"k7Qz9R\",\"transfer_title\":\"Dossier client Q3\",\"status\":\"pending\",\"expires_at\":\"2026-06-08T14:30:00.000Z\",\"max_downloads\":5,\"total_downloads\":0,\"scan_status\":\"pending\",\"encryption_mode\":\"sse-s3\",\"created_at\":\"2026-06-05T14:30:00.000Z\"},\"upload_urls\":[{\"file_id\":\"contrat-q3.pdf\",\"url\":\"https://storage.coffrify.com/upload/a3f1c9e2/contrat-q3.pdf?X-Amz-Signature=...\",\"headers\":{\"Content-Type\":\"application/octet-stream\"}},{\"file_id\":\"annexe.xlsx\",\"url\":\"https://storage.coffrify.com/upload/a3f1c9e2/annexe.xlsx?X-Amz-Signature=...\",\"headers\":{\"Content-Type\":\"application/octet-stream\"}}],\"share_url\":\"https://files.coffrify.com/k7Qz9R\",\"totp_secret\":null}"

Crée un nouveau transfert dans le workspace authentifié et renvoie des URL d'upload pré-signées, une par fichier déclaré. L'endpoint ne reçoit pas les octets des fichiers : vous lui transmettez seulement la liste des métadonnées (name, size, mime_type), il provisionne le transfert côté Coffrify puis vous renvoie des URL vers lesquelles votre client envoie ensuite directement le contenu (PUT). Comportement notable : le transfert est créé en statut initial (en attente d'upload) et n'apparaît pleinement actif qu'une fois les fichiers déposés ; chaque URL d'upload est accompagnée de ses headers obligatoires, qui peuvent inclure des en-têtes de chiffrement SSE-KMS si le chiffrement serveur est activé, sinon un simple Content-Type. La requête accepte indifféremment les clés en snake_case (recommandé) ou en camelCase historique.

Authentification

Requiert une clé API valide présentée via Authorization: Bearer cof_live_... (ou cof_test_, cof_rk_*, cof_mcp_*). La clé doit porter le scope transfers:write. Cet endpoint applique aussi l'idempotence : envoyez un en-tête Idempotency-Key unique pour pouvoir réémettre la même création sans risque de doublon.

Corps de la requête

Le corps doit être un objet JSON. Le seul champ strictement obligatoire est files, un tableau non vide ; tous les autres champs sont facultatifs et contrôlent la durée de vie, la protection et le comportement du transfert.

Réponse

Renvoie un statut 201 avec un objet contenant : transfer, l'enregistrement du transfert créé (id, short_code, transfer_title, status, expires_at, max_downloads, total_downloads, scan_status, encryption_mode, created_at) ; upload_urls, un tableau d'objets { file_id, url, headers } où file_id correspond au name du fichier, url est l'URL pré-signée vers laquelle envoyer le contenu, et headers les en-têtes obligatoires à inclure dans le PUT (Content-Type, et le cas échéant les en-têtes SSE-KMS) ; share_url, l'URL publique de partage (https://files.coffrify.com/<short_code>) ; et totp_secret, le secret TOTP renvoyé uniquement si require_totp est activé (sinon null).

Erreurs

Voir aussi

• GET /v1/transfers : liste paginée des transferts du workspace (filtres status, search, folder_id, scan_status).
• GET /v1/transfers/{id} : récupère le détail d'un transfert existant.
• POST /v1/transfers/{id}/resolve : résout/finalise l'accès à un transfert (mot de passe, TOTP).