Réponse exemple
Supprime définitivement un document rattaché à une data room du workspace. La suppression est physique : le document est retiré de la table coffrify_dataroom_documents, et les vues techniques liées (coffrify_dataroom_views) disparaissent en cascade. Ce comportement assume un faible volume par data room (contexte M&A : 10 à 200 documents typiquement). Pour préserver la traçabilité, l'opération écrit une entrée d'audit dataroom.document_removed dans coffrify_audit_log, qui reste consultable par le responsable conformité même après la disparition du document.
/v1/workspace/datarooms/{id}/documents/{docId}Supprime le document {docId} de la data room {id}.Authentification
Cette route s'appuie sur la session authentifiée (cookie Supabase) et non sur un scope de clé API : aucun scope spécifique n'est requis. L'accès est contrôlé par le rôle du membre dans le workspace actif. Seuls les rôles owner, admin et member (les rôles « gestionnaires ») sont autorisés à supprimer un document. Le workspace ciblé est résolu via le cookie cf-workspace-id ; à défaut, le premier workspace actif de l'utilisateur est utilisé.
Paramètres de chemin
| Champ | Type | Requis | Description |
|---|---|---|---|
| id | string (uuid) | Oui | Identifiant de la data room. Doit appartenir au workspace actif. |
| docId | string (uuid) | Oui | Identifiant du document à supprimer. Doit appartenir à la data room ciblée (dataroom_id = id). |
Réponse
En cas de succès, l'API renvoie un statut 200 avec un corps minimal { "ok": true }. Aucune donnée du document supprimé n'est retournée. L'entrée d'audit créée contient l'actorId, l'action dataroom.document_removed, le resourceId (la data room) et des métadonnées comprenant le document_id et le title du document supprimé.
Erreurs
| Code | Quand | Résolution |
|---|---|---|
| 401 Unauthorized | Aucune session valide (user absent). | Authentifiez l'appel avec une session Coffrify valide. |
| 404 No active workspace | Aucun workspace actif résolu pour l'utilisateur. | Sélectionnez un workspace (cookie cf-workspace-id) ou rejoignez un workspace actif. |
| 403 Insufficient permissions | Le rôle du membre n'est pas owner, admin ni member. | Demandez un rôle gestionnaire ou faites effectuer la suppression par un membre habilité. |
| 404 Not found | Le document n'existe pas, n'appartient pas à la data room indiquée, ou la data room n'appartient pas au workspace. | Vérifiez id et docId, et que la data room relève bien du workspace actif. |
| 500 Internal Server Error | Échec de la suppression en base (message d'erreur Postgres renvoyé). | Réessayez ; si l'erreur persiste, contactez le support avec le message renvoyé. |
Voir aussi
- GET /v1/workspace/datarooms/{id}/documents : lister les documents d'une data room.
- POST /v1/workspace/datarooms/{id}/documents : ajouter un document à une data room.
- GET /v1/workspace/datarooms/{id} : récupérer les détails d'une data room.