POST/v1/templates

Créer un modèle

Crée un modèle de transfert.

Requête exemple

{
  "name": "Configuration sensible",
  "description": "Auth + filigrane",
  "require_totp": true,
  "max_downloads": 5,
  "watermark_text": "Confidentiel",
  "burn_after_read": true,
  "expires_in_hours": 24,
  "watermark_enabled": true,
  "require_email_verification": true
}

Réponse exemple

{
  "id": "tpl_new1234567890",
  "name": "Configuration sensible",
  "use_count": 0,
  "created_at": "2026-06-05T10:00:00Z",
  "require_totp": true,
  "max_downloads": 5,
  "watermark_text": "Confidentiel",
  "burn_after_read": true,
  "expires_in_hours": 24,
  "watermark_enabled": true,
  "require_email_verification": true
}

Crée un modèle de transfert réutilisable, stockant les réglages de sécurité, d'authentification et d'expiration par défaut.

Authentification

Requiert une clé API avec le scope templates:manage.

Corps de la requête

Champ	Type	Requis	Description
name	string	Oui	Nom du modèle.
description	string	Non	Description.
is_default	boolean	Non	Modèle par défaut (défaut `false`).
expires_in_hours	number	Non	Expiration en heures (min 1, défaut 48).
max_downloads	number	Non	Téléchargements max.
password	string	Non	Mot de passe d'accès.
require_totp	boolean	Non	Exiger un TOTP.
watermark_enabled	boolean	Non	Activer le filigrane.
watermark_text	string	Non	Texte du filigrane.
burn_after_read	boolean	Non	Supprimer après lecture.
require_email_verification	boolean	Non	Exiger une vérification e-mail.
geo_allowlist	array	Non	Codes pays autorisés (ex. `["FR","US"]`).

Codes de statut

201 Modèle créé.
400 Validation (nom manquant).
403 Scope insuffisant.