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érationAppel
Lister les membresGET /workspace/membersGratuit
Lister les invitationsGET /workspace/invitationsGratuit
Inviter un membrePOST /workspace/invitationsGratuit
Annuler une invitationDELETE /workspace/invitations/{invitationId}Gratuit
Modifier un membrePATCH /workspace/members/{userId}Gratuit
Retirer un membreDELETE /workspace/members/{userId}Gratuit

Lister les membres

GET/workspace/membersGratuit

Les membres de l'espace et leur rôle.

Outil MCP list_members

Requête
curl https://app.semchat.io/api/v1/workspace/members \
  -H "Authorization: Bearer sk_live_…"
Réponse · 200
{
  "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

GET/workspace/invitationsGratuit

Les 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

Requête
curl https://app.semchat.io/api/v1/workspace/invitations \
  -H "Authorization: Bearer sk_live_…"

Répond 200 avec { "data": … }.

Inviter un membre

POST/workspace/invitationsGratuit

Inviter 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

ArgumentTypeDescription
emailobligatoirestring
roleobligatoirestringadmin ou member (par défaut).admin | member
Requête
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

DELETE/workspace/invitations/{invitationId}Gratuit

Annuler 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

ArgumentTypeDescription
invitationIddans le cheminstringSon identifiant.
Requête
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

PATCH/workspace/members/{userId}Gratuit

Changer 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

ArgumentTypeDescription
userIddans le cheminstringSon identifiant.
roleobligatoirestringadmin | member
Requête
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

DELETE/workspace/members/{userId}Gratuit

Retirer 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

ArgumentTypeDescription
userIddans le cheminstringSon identifiant.
Requête
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.

Prêt à faire décoller votre site ?

Posez votre première question - semchat vous répond avec un plan d'action clair, en quelques secondes.

Gratuit · sans inscription · en 5 secondes