POST/v1/rooms

Créer une room

Crée une room partagée.

Requête exemple

{
  "name": "Audit Financier Q4",
  "password": "S3cret!",
  "description": "Documents pour l'audit annuel",
  "allow_download": true,
  "expires_in_days": 90,
  "watermark_enabled": true
}

Réponse exemple

{
  "id": "room_abc123xyz",
  "name": "Audit Financier Q4",
  "slug": "a1b2c3d4",
  "share_url": "https://files.coffrify.com/room/a1b2c3d4",
  "created_at": "2026-06-05T14:32:00Z",
  "expires_at": "2026-09-05T14:32:00Z",
  "allow_download": true,
  "watermark_enabled": true,
  "is_password_protected": true
}

Crée une room sécurisée et renvoie son URL de partage unique.

Authentification

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

Corps de la requête

Champ	Type	Requis	Description
name	string	Oui	Nom de la room.
description	string	Non	Description.
expires_in_days	number	Non	Jours avant expiration (1 à 365, défaut 30).
password	string	Non	Mot de passe d'accès.
watermark_enabled	boolean	Non	Filigrane sur les documents (défaut `true`).
allow_download	boolean	Non	Autoriser le téléchargement (défaut `true`).

Codes de statut

201 Room créée.
400 name manquant.
403 Scope insuffisant.