Créer une demande de fichiers

Crée un formulaire de réception de fichiers.

Requête exemple

{
  "title": "Demande de devis",
  "password": "S3cret!",
  "cover_emoji": "💼",
  "description": "Envoyez vos devis",
  "notify_email": "admin@company.com",
  "allowed_emails": [
    "client@example.com"
  ],
  "max_submissions": 100,
  "max_file_size_mb": 500,
  "is_password_protected": true,
  "max_files_per_submission": 10
}

Réponse exemple

{
  "id": "req_new456",
  "title": "Demande de devis",
  "status": "active",
  "created_at": "2026-06-05T15:20:00Z",
  "short_code": "new45678",
  "cover_emoji": "💼",
  "max_submissions": 100,
  "max_file_size_mb": 500,
  "total_submissions": 0,
  "is_password_protected": true
}

Crée un formulaire de demande de fichiers. title est requis ; si is_password_protected est vrai, password l'est aussi.

Authentification

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

Corps de la requête

Champ	Type	Requis	Description
title	string	Oui	Titre (max 200 car.).
description	string	Non	Description (max 2000 car.).
is_password_protected	boolean	Non	Si vrai, exige `password`.
password	string	Cond.	Mot de passe (si protégé).
allowed_emails	array	Non	E-mails autorisés à déposer.
expires_at	string	Non	Date d'expiration ISO 8601.
max_submissions	number	Non	Nombre max de dépôts.
notify_email	string	Non	E-mail de notification.
max_file_size_mb	number	Non	Taille max par fichier : 100, 500, 1000 ou 2000.
max_files_per_submission	number	Non	Fichiers max par dépôt (1 à 100).

Codes de statut

201 Demande créée.
400 Validation.
403 Scope insuffisant.