Référence APIRetirer un membre du workspace
DELETE/v1/workspace/members/{memberId}

Retirer un membre du workspace

Supprime définitivement un membre du workspace actif.

1 min de lectureTélécharger en PDF

Réponse exemple

{
"id": "mbr_8f2c1a7e",
"deleted": true
}
DELETE/v1/workspace/members/{memberId}Retire définitivement un membre du workspace actif, identifié par memberId.

Cette route retire un membre du workspace actif, identifié par memberId. La suppression est définitive : la ligne d'adhésion est effacée. Plusieurs garde-fous s'appliquent : le membre cible doit appartenir au même workspace que l'appelant, le propriétaire du workspace ne peut pas être retiré, et l'appelant ne peut pas se retirer lui-même.

Authentification

L'accès repose sur une session authentifiée (cookie de session Supabase), sans scope de clé API spécifique. L'appelant doit être membre actif du workspace avec le rôle owner ou admin ; à défaut, la requête renvoie 403 (Insufficient permissions).

Paramètres de requête

ParamètreTypeRequisDescription
memberIdstring (path)OuiIdentifiant de la ligne d'adhésion (coffrify_workspace_members.id) du membre à retirer.

Réponse

En cas de succès (200), la réponse confirme la suppression avec deleted: true et renvoie l'id du membre retiré. La méthode ne renvoie pas de corps de requête (aucun payload n'est lu).

Erreurs

CodeQuandRésolution
401Session absente ou expirée (utilisateur non authentifié)Authentifiez-vous puis renvoyez la requête.
403Appelant non owner/admin, membre cible hors workspace, cible de rôle owner, ou tentative d'auto-suppressionVérifiez vos droits ; pour transférer la propriété ou quitter le workspace, utilisez le flux dédié plutôt que cette route.
404Aucun workspace actif, ou membre introuvableVérifiez le contexte du workspace actif et l'identifiant memberId.
500Échec de la suppression côté base de donnéesRéessayez ; si l'erreur persiste, contactez le support.

Voir aussi