Statistiques d'activité par membre

Réponse exemple

{
  "data": [
    {
      "role": "owner",
      "email": "claire@exemple.fr",
      "status": "active",
      "user_id": "usr_91kf02la",
      "member_id": "wm_1a2b3c4d",
      "audit_events": 154,
      "last_activity_at": "2026-06-04T16:42:11.000Z",
      "transfers_created": 32,
      "storage_bytes_produced": 4012398080,
      "downloads_triggered_via_share": 96
    },
    {
      "role": "member",
      "email": "marc@exemple.fr",
      "status": "active",
      "user_id": "usr_22ld88kk",
      "member_id": "wm_5e6f7g8h",
      "audit_events": 59,
      "last_activity_at": "2026-06-03T11:08:54.000Z",
      "transfers_created": 15,
      "storage_bytes_produced": 1297847808,
      "downloads_triggered_via_share": 32
    },
    {
      "role": "member",
      "email": "invite@exemple.fr",
      "status": "invited",
      "user_id": null,
      "member_id": "wm_9i0j1k2l",
      "audit_events": 0,
      "last_activity_at": null,
      "transfers_created": 0,
      "storage_bytes_produced": 0,
      "downloads_triggered_via_share": 0
    }
  ],
  "since": "2026-05-06T09:00:00.000Z",
  "object": "list",
  "totals": {
    "audit_events": 213,
    "transfers_created": 47,
    "downloads_triggered": 128,
    "storage_bytes_produced": 5310245888
  },
  "range_days": 30,
  "member_count": 3,
  "workspace_id": "ws_8f2c1a4b9d"
}

Cet endpoint produit une vue d'activité par membre du workspace courant sur les days derniers jours. Pour chaque membre (y compris les invitations en attente sans user_id), il agrège le nombre de transferts créés, le volume de stockage produit (en octets), les téléchargements déclenchés via les liens de partage, et le nombre d'événements d'audit. La réponse inclut aussi un bloc totals consolidant ces métriques sur l'ensemble des membres. C'est une vue pensée pour la conformité et l'audit : elle permet de répondre à la question "qui a fait quoi, et combien, sur la période".

Comportement notable : la liste data est triée du membre le plus actif au moins actif, le score d'activité étant la somme transfers_created + audit_events. Les emails sont hydratés depuis les profils pour les membres actifs, et depuis le champ d'invitation pour les membres encore invités. C'est un endpoint classé `expensive` : il effectue plusieurs requêtes par membre (transferts, fichiers, téléchargements, audit), il consomme donc le quota de débit des endpoints coûteux plus rapidement qu'un GET standard.

Authentification

Requiert une clé API valide portant le scope members:read. Conformément à la hiérarchie des scopes, le scope plus large workspace:manage (god-mode workspace) satisfait également cette exigence, tout comme le wildcard *. Présentez le credential via l'en-tête Authorization: Bearer cof_live_... (ou cof_test_...). Si le token ne porte pas un scope suffisant, l'API renvoie 403 scope_missing.

Paramètres de requête

Réponse

Réponse 200 de type liste (object: "list"). Champs de premier niveau : workspace_id, range_days (la fenêtre effectivement appliquée), since (borne basse ISO 8601), member_count, un objet totals (transfers_created, storage_bytes_produced, downloads_triggered, audit_events), et data, le tableau des membres.

Chaque entrée de data contient : member_id (id de la ligne d'appartenance), user_id (nullable pour une invitation en attente), email, role, status, transfers_created, storage_bytes_produced, downloads_triggered_via_share, audit_events, et last_activity_at (date du transfert le plus récent du membre, ou null). Les membres sans user_id apparaissent avec toutes leurs métriques à zéro.

Erreurs

Voir aussi

• GET /v1/workspace/members : lister les membres et invitations du workspace.
• GET /v1/transfers : détail des transferts qui alimentent ces compteurs.
• GET /v1/audit : journal d'audit brut sous-jacent aux compteurs d'événements.