Réponse exemple
Récupère le détail complet d'une data room M&A identifiée par son id, à condition qu'elle appartienne au workspace actif de l'utilisateur. La réponse renvoie toutes les colonnes de la data room (coffrify_datarooms) auxquelles s'ajoute un bloc stats agrégé en temps réel : nombre de viewers (total et actifs), nombre de documents, nombre de questions (total et ouvertes) et horodatage de la dernière activité enregistrée dans le journal des consultations.
/v1/workspace/datarooms/{id}Détail d'une data room du workspace courant avec statistiques agrégées.Authentification
Cette route exige une session utilisateur valide (cookie de session Supabase) ; elle ne consomme aucun scope de clé API spécifique. L'accès est borné au workspace résolu via le cookie cf-workspace-id (à défaut, le premier workspace actif de l'utilisateur). Toute data room dont le workspace_id ne correspond pas au workspace actif est traitée comme introuvable (404), ce qui évite toute fuite d'existence entre workspaces.
Paramètres de requête
| Champ | Type | Requis | Description |
|---|---|---|---|
| id | string (path) | Oui | Identifiant de la data room à consulter. Doit appartenir au workspace actif. |
Réponse
La réponse 200 contient l'intégralité des champs de la data room (id, name, target_company, description, status, reference, expires_at, nda_required, nda_template_text, closed_at, archived_at, etc.) ainsi qu'un objet stats calculé à la volée :
| Champ stats | Type | Description |
|---|---|---|
| viewers_count | number | Nombre total de viewers invités sur la data room. |
| viewers_active_count | number | Nombre de viewers au statut active. |
| documents_count | number | Nombre de documents rattachés à la data room. |
| questions_count | number | Nombre total de questions (Q&A) posées. |
| questions_open_count | number | Nombre de questions au statut open. |
| last_activity_at | string | null | Horodatage ISO de la dernière consultation enregistrée, ou null si aucune activité. |
Erreurs
| Code | Quand | Résolution |
|---|---|---|
| 401 | Aucune session utilisateur valide (Unauthorized). | Authentifiez-vous et transmettez le cookie de session valide. |
| 404 | Aucun workspace actif résolu (No active workspace). | Sélectionnez un workspace actif (cookie cf-workspace-id) ou rejoignez un workspace. |
| 404 | Data room inexistante ou hors du workspace actif (Not found). | Vérifiez l'id et que la data room appartient bien au workspace courant. |
Voir aussi
- PATCH /v1/workspace/datarooms/{id} — mettre à jour le nom, le statut, l'expiration ou la NDA d'une data room.
- GET /v1/workspace/datarooms — lister les data rooms du workspace.
- GET /v1/workspace/datarooms/{id}/viewers — détailler les viewers invités sur la data room.