DocumentazioneRiferimento API
Membri
I membri dello spazio di lavoro, i loro ruoli e gli inviti.
Ogni operazione qui sotto è anche uno strumento MCP, con lo stesso nome. Le operazioni Gratis non costano nulla; quelle A pagamento usano i crediti dello spazio di lavoro, come nell'app (Quanto costa).
| Operazione | Chiamata | |
|---|---|---|
| Elenca i membri | GET /workspace/members | Gratis |
| Elenca gli inviti | GET /workspace/invitations | Gratis |
| Invita un membro | POST /workspace/invitations | Gratis |
| Annulla un invito | DELETE /workspace/invitations/{invitationId} | Gratis |
| Modifica un membro | PATCH /workspace/members/{userId} | Gratis |
| Rimuovi un membro | DELETE /workspace/members/{userId} | Gratis |
Elenca i membri
/workspace/membersGratisI membri dello spazio di lavoro e il loro ruolo.
Strumento 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"
}
]
}Elenca gli inviti
/workspace/invitationsGratisGli inviti in attesa dello spazio di lavoro.
- Solo proprietario o amministratore (il ruolo di chi ha creato la chiave): altrimenti 403 FORBIDDEN.
Strumento MCP list_invitations
curl https://app.semchat.io/api/v1/workspace/invitations \
-H "Authorization: Bearer sk_live_…"Risponde 200 con { "data": … }.
Invita un membro
/workspace/invitationsGratisInvita qualcuno nello spazio di lavoro via email: riceve l'email di invito, valida 7 giorni.
- Solo proprietario o amministratore (il ruolo di chi ha creato la chiave): altrimenti 403 FORBIDDEN.
- 409 CONFLICT quando l'email è già di un membro o è già stata invitata.
Strumento MCP invite_member
| Argomento | Tipo | Descrizione |
|---|---|---|
emailobbligatorio | string | |
roleobbligatorio | string | admin o member (predefinito).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"}'Risponde 201 con { "data": … }.
Annulla un invito
/workspace/invitations/{invitationId}GratisAnnulla un invito: il suo link smette di funzionare.
- Solo proprietario o amministratore (il ruolo di chi ha creato la chiave): altrimenti 403 FORBIDDEN.
Strumento MCP cancel_invitation
| Argomento | Tipo | Descrizione |
|---|---|---|
invitationIdnel percorso | string | Il suo id. |
curl -X DELETE https://app.semchat.io/api/v1/workspace/invitations/{invitationId} \
-H "Authorization: Bearer sk_live_…"Risponde 200 con { "data": … }.
Modifica un membro
/workspace/members/{userId}GratisCambia il ruolo di un membro (admin o member).
- Solo proprietario o amministratore (il ruolo di chi ha creato la chiave): altrimenti 403 FORBIDDEN.
- userId come lo mostra list_members. Il ruolo del proprietario non si può cambiare.
Strumento MCP update_member
| Argomento | Tipo | Descrizione |
|---|---|---|
userIdnel percorso | string | Il suo id. |
roleobbligatorio | 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"}'Risponde 200 con { "data": … }.
Rimuovi un membro
/workspace/members/{userId}GratisRimuovi un membro dallo spazio di lavoro.
- Proprietario o amministratore, tranne per rimuovere te stesso (chi ha creato la chiave lascia lo spazio di lavoro). Il proprietario non può essere rimosso.
Strumento MCP remove_member
| Argomento | Tipo | Descrizione |
|---|---|---|
userIdnel percorso | string | Il suo id. |
curl -X DELETE https://app.semchat.io/api/v1/workspace/members/{userId} \
-H "Authorization: Bearer sk_live_…"Risponde 200 con { "data": … }.
Hai una domanda a cui qui non trovi risposta? Scrivici.

