Réponse exemple
Cette route renvoie l'ensemble des viewers (destinataires d'accès) rattachés à une data room donnée du workspace actif. Les viewers sont triés par date d'invitation décroissante (invited_at du plus récent au plus ancien). La data room doit appartenir au workspace résolu pour l'appelant, sinon la requête échoue avec un 404. Le token_hash et le jeton brut d'accès ne sont jamais exposés ici : seul le viewer reçoit son lien magique par email.
Authentification
L'appel s'authentifie via la session Coffrify (cookies Supabase). Aucun scope de clé API spécifique n'est requis, mais l'utilisateur doit être membre active d'un workspace. Le workspace ciblé est déterminé par le cookie cf-workspace-id (ou, à défaut, le premier workspace actif de l'utilisateur). La data room doit appartenir à ce workspace pour être lisible.
Paramètres de requête
| Champ | Type | Requis | Description |
|---|---|---|---|
| id | string (path) | Oui | Identifiant de la data room dont on liste les viewers. Doit appartenir au workspace actif. |
Réponse
La réponse est un objet liste : object vaut "list" et data contient le tableau des viewers. Chaque viewer expose : id, email, name, company, role, status (par ex. invited, active, révoqué), nda_signed_at, invited_at, last_seen_at, revoked_at et revoked_reason. Les champs name, company et role peuvent être null lorsqu'ils n'ont pas été renseignés à l'invitation.
Erreurs
| Code | Quand | Résolution |
|---|---|---|
| 401 Unauthorized | Aucune session valide (utilisateur non authentifié). | Authentifiez-vous et réessayez avec une session valide. |
| 404 No active workspace | L'utilisateur n'a aucun workspace actif résolu. | Sélectionnez un workspace (cookie cf-workspace-id) ou vérifiez votre appartenance active. |
| 404 Not found | La data room n'existe pas ou n'appartient pas au workspace actif. | Vérifiez l'id de la data room et le workspace ciblé. |
| 500 | Erreur lors de la lecture des viewers en base. | Réessayez ultérieurement ; si l'erreur persiste, contactez le support. |
Voir aussi
POST/v1/workspace/datarooms/{id}/viewersInviter un nouveau viewer (ou réinviter un viewer existant) sur la data room.POST/v1/workspace/datarooms/{id}/viewers/{viewerId}/resendRégénérer et renvoyer le lien magique d'un viewer existant.