Se connecterCommencer gratuitement
Référence APIAppliquer un modèle
POST/v1/templates/{id}/apply

Appliquer un modèle

Crée un transfert à partir d'un modèle.

1 min de lectureTélécharger en PDF

Requête exemple

{
  "files": [
    {
      "name": "document.pdf",
      "size": 2048576,
      "mime_type": "application/pdf"
    }
  ],
  "overrides": {
    "expires_in_hours": 12,
    "watermark_enabled": true
  },
  "recipient": "john@example.com"
}

Réponse exemple

{
  "transfer": {
    "id": "tr_1234567890abcdef",
    "expires_at": "2026-06-06T11:45:00Z",
    "short_code": "abc123xyz"
  },
  "share_url": "https://files.coffrify.com/abc123xyz",
  "upload_urls": [
    {
      "url": "https://coffrify-transfer.s3.fr-par.scw.cloud/transfers/tr_1234567890abcdef/document.pdf?X-Amz-...",
      "file_id": "document.pdf"
    }
  ]
}

Crée un transfert en appliquant un modèle comme base, avec surcharges optionnelles. Renvoie les URL d'upload présignées.

Authentification

Requiert une clé API avec le scope transfers:write.

Corps de la requête

ChampTypeRequisDescription
filesarrayOuiFichiers à transférer (name, size, mime_type).
recipientstringNonE-mail du destinataire.
overridesobjectNonSurcharges du modèle (expires_in_hours, watermark_enabled, watermark_text, burn_after_read, geo_allowlist).

Codes de statut

  • 201 Transfert créé.
  • 400 files manquant.
  • 404 Modèle introuvable.
  • 403 Scope insuffisant.