Référence APILister les viewers d'une data room
GET/v1/workspace/datarooms/{id}/viewers

Lister les viewers d'une data room

Renvoie la liste de tous les viewers invites sur une data room du workspace actif.

1 min de lectureTélécharger en PDF

Réponse exemple

{
"data": [
{
"id": "v_3f9a8c21-0e4d-4b77-9a12-7c5e1d8f0b3a",
"name": "Camille Durand",
"role": "Lead investor",
"email": "investisseur@fonds-alpha.com",
"status": "active",
"company": "Fonds Alpha Capital",
"invited_at": "2026-05-27T16:40:11.000Z",
"revoked_at": null,
"last_seen_at": "2026-06-04T08:22:45.000Z",
"nda_signed_at": "2026-05-28T09:14:02.000Z",
"revoked_reason": null
},
{
"id": "v_7b2e4d10-aa31-4c09-bf55-12d9e0a4c7f1",
"name": null,
"role": null,
"email": "conseil@cabinet-mlt.fr",
"status": "invited",
"company": null,
"invited_at": "2026-05-30T11:05:00.000Z",
"revoked_at": null,
"last_seen_at": null,
"nda_signed_at": null,
"revoked_reason": null
}
],
"object": "list"
}

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

ChampTypeRequisDescription
idstring (path)OuiIdentifiant 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

CodeQuandRésolution
401 UnauthorizedAucune session valide (utilisateur non authentifié).Authentifiez-vous et réessayez avec une session valide.
404 No active workspaceL'utilisateur n'a aucun workspace actif résolu.Sélectionnez un workspace (cookie cf-workspace-id) ou vérifiez votre appartenance active.
404 Not foundLa data room n'existe pas ou n'appartient pas au workspace actif.Vérifiez l'id de la data room et le workspace ciblé.
500Erreur 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.