Lister les demandes de capability en attente

Récupère les demandes de capability au statut « pending » d'un workspace : l'owner voit toutes les demandes, un membre ne voit que les siennes.

1 min de lectureTélécharger en PDF

Réponse exemple

{
  "data": [
    {
      "id": "creq_4d9b17e2",
      "note": "J'ai besoin d'accéder à la facturation pour régulariser l'abonnement.",
      "status": "pending",
      "capability": "can_manage_billing",
      "created_at": "2026-06-05T09:42:11.503Z",
      "requested_by_email": "marie@exemple.com",
      "requested_by_user_id": "usr_a17c93"
    }
  ],
  "object": "list"
}

GET/v1/workspace/capability-requests?workspace_id=...Lister les demandes de capability en attente d'un workspace.

Renvoie la liste des demandes de capability au statut `pending` pour un workspace, triées par date de création croissante. La visibilité dépend du rôle : l'owner du compte propriétaire voit toutes les demandes du workspace (vue « inbox » d'approbation), tandis qu'un membre non-owner ne voit que ses propres demandes. Pour chaque entrée, l'email du demandeur est résolu afin d'afficher facilement l'inbox côté owner.

Authentification

Authentification par session utilisateur (cookie Supabase), sans clé API à scope : clé API valide, aucun scope spécifique. L'appelant doit être membre actif du workspace ; le filtrage par rôle (owner vs membre) est appliqué automatiquement côté serveur.

Paramètres de requête

Champ	Type	Requis	Description
workspace_id	string	Oui	Identifiant du workspace dont on liste les demandes en attente.

Réponse

La réponse est une liste : object vaut "list" et data contient les demandes. Chaque demande expose id, capability, status (pending), note (ou null), created_at, requested_by_user_id et requested_by_email (l'email du demandeur, ou null s'il n'a pu être résolu). Seules les demandes en attente sont retournées ; les demandes déjà décidées n'apparaissent pas.

Erreurs

Code	Quand	Résolution
400	Paramètre `workspace_id` absent (`workspace_id required`).	Ajouter `?workspace_id=...` à l'URL.
401	Aucune session utilisateur valide (`unauthorized`).	S'authentifier avant d'appeler la route.
403	L'appelant n'est pas membre actif du workspace (`not a member of this workspace`).	Vérifier l'appartenance au workspace ou le `workspace_id`.

Voir aussi

POST /v1/workspace/capability-requests — créer une demande de capability.
Approuver ou refuser une demande de capability (inbox owner).
Lister les membres d'un workspace et leurs capabilities.