DocumentationRéférence de l'API
Membres
Les membres de l'espace, leurs rôles et les invitations.
Chaque opération ci-dessous est aussi un outil MCP, sous le même nom. Les opérations marquées Gratuit ne coûtent rien ; celles marquées Facturé utilisent les crédits de l'espace, comme dans l'app (Ce que ça coûte).
| Opération | Appel | |
|---|---|---|
| Lister les membres | GET /workspace/members | Gratuit |
| Lister les invitations | GET /workspace/invitations | Gratuit |
| Inviter un membre | POST /workspace/invitations | Gratuit |
| Annuler une invitation | DELETE /workspace/invitations/{invitationId} | Gratuit |
| Modifier un membre | PATCH /workspace/members/{userId} | Gratuit |
| Retirer un membre | DELETE /workspace/members/{userId} | Gratuit |
Lister les membres
/workspace/membersGratuitLes membres de l'espace et leur rôle.
Outil MCP list_members
curl https://app.semchat.io/api/v1/workspace/members \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"user_id": "01995d03-8ea0-7e30-9bc8-4a6a79a79b4f",
"name": "Olivia Owner",
"email": "owner@example.com",
"role": "owner",
"joined_at": "2025-09-18T13:28:58.000Z"
},
{
"user_id": "01995d05-6360-74e9-8aa2-63377289227a",
"name": "Adam Admin",
"email": "admin@example.com",
"role": "admin",
"joined_at": "2026-07-15T13:26:58.000Z"
}
]
}Lister les invitations
/workspace/invitationsGratuitLes invitations de l'espace en attente.
- Propriétaire ou administrateur uniquement (le rôle du créateur de la clé) : 403 FORBIDDEN sinon.
Outil MCP list_invitations
curl https://app.semchat.io/api/v1/workspace/invitations \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Inviter un membre
/workspace/invitationsGratuitInviter quelqu'un dans l'espace par e-mail : la personne reçoit l'e-mail d'invitation, valable 7 jours.
- Propriétaire ou administrateur uniquement (le rôle du créateur de la clé) : 403 FORBIDDEN sinon.
- 409 CONFLICT quand l'adresse est déjà membre ou déjà invitée.
Outil MCP invite_member
| Argument | Type | Description |
|---|---|---|
emailobligatoire | string | |
roleobligatoire | string | admin ou member (par défaut).admin | member |
curl -X POST https://app.semchat.io/api/v1/workspace/invitations \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"email": "name@example.com", "role": "admin"}'Répond 201 avec { "data": … }.
Annuler une invitation
/workspace/invitations/{invitationId}GratuitAnnuler une invitation : son lien cesse de fonctionner.
- Propriétaire ou administrateur uniquement (le rôle du créateur de la clé) : 403 FORBIDDEN sinon.
Outil MCP cancel_invitation
| Argument | Type | Description |
|---|---|---|
invitationIddans le chemin | string | Son identifiant. |
curl -X DELETE https://app.semchat.io/api/v1/workspace/invitations/{invitationId} \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Modifier un membre
/workspace/members/{userId}GratuitChanger le rôle d'un membre (admin ou member).
- Propriétaire ou administrateur uniquement (le rôle du créateur de la clé) : 403 FORBIDDEN sinon.
- userId tel que list_members l'affiche. Le rôle du propriétaire ne peut pas être changé.
Outil MCP update_member
| Argument | Type | Description |
|---|---|---|
userIddans le chemin | string | Son identifiant. |
roleobligatoire | string | admin | member |
curl -X PATCH https://app.semchat.io/api/v1/workspace/members/{userId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"role": "admin"}'Répond 200 avec { "data": … }.
Retirer un membre
/workspace/members/{userId}GratuitRetirer un membre de l'espace.
- Propriétaire ou administrateur, sauf pour vous retirer vous-même (le créateur de la clé quitte l'espace). Le propriétaire ne peut pas être retiré.
Outil MCP remove_member
| Argument | Type | Description |
|---|---|---|
userIddans le chemin | string | Son identifiant. |
curl -X DELETE https://app.semchat.io/api/v1/workspace/members/{userId} \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Une question sans réponse ici ? Écrivez-nous.

