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).

OperazioneChiamata
Elenca i membriGET /workspace/membersGratis
Elenca gli invitiGET /workspace/invitationsGratis
Invita un membroPOST /workspace/invitationsGratis
Annulla un invitoDELETE /workspace/invitations/{invitationId}Gratis
Modifica un membroPATCH /workspace/members/{userId}Gratis
Rimuovi un membroDELETE /workspace/members/{userId}Gratis

Elenca i membri

GET/workspace/membersGratis

I membri dello spazio di lavoro e il loro ruolo.

Strumento MCP list_members

Richiesta
curl https://app.semchat.io/api/v1/workspace/members \
  -H "Authorization: Bearer sk_live_…"
Risposta · 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"
    }
  ]
}

Elenca gli inviti

GET/workspace/invitationsGratis

Gli 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

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

Risponde 200 con { "data": … }.

Invita un membro

POST/workspace/invitationsGratis

Invita 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

ArgomentoTipoDescrizione
emailobbligatoriostring
roleobbligatoriostringadmin o member (predefinito).admin | member
Richiesta
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

DELETE/workspace/invitations/{invitationId}Gratis

Annulla 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

ArgomentoTipoDescrizione
invitationIdnel percorsostringIl suo id.
Richiesta
curl -X DELETE https://app.semchat.io/api/v1/workspace/invitations/{invitationId} \
  -H "Authorization: Bearer sk_live_…"

Risponde 200 con { "data": … }.

Modifica un membro

PATCH/workspace/members/{userId}Gratis

Cambia 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

ArgomentoTipoDescrizione
userIdnel percorsostringIl suo id.
roleobbligatoriostringadmin | member
Richiesta
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

DELETE/workspace/members/{userId}Gratis

Rimuovi 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

ArgomentoTipoDescrizione
userIdnel percorsostringIl suo id.
Richiesta
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.

Pronto a far decollare il tuo sito?

Fai la tua prima domanda - semchat ti risponde con un piano d'azione chiaro in pochi secondi.

Gratis · senza registrazione · in 5 secondi