For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /it/docs/mobile/workspaces.md (or send Accept: text/markdown).
Workspace e membri
Cambia workspace, amministra l'organizzazione e gestisci gli inviti.
Risolvi il workspace attivo
GET /api/workspaces restituisce le appartenenze ai workspace del membro e l'id del workspace attivo; POST con un id di workspace cambia. Il server risolve il contesto dal cookie di selezione alla preferenza memorizzata al workspace personale e verifica l'appartenenza effettiva, così una selezione falsificata o obsoleta non può leggere un altro workspace.
Gestisci l'organizzazione
GET /api/mobile/organization restituisce membri, inviti in sospeso, utilizzo dei posti e le capacità del chiamante — canManage e canLeave; un workspace personale risponde invece notOrganization. POST crea un'organizzazione, PATCH la rinomina (solo owner) e DELETE la rimuove (solo owner, con conferma digitando il nome).
Le schermate dell'organizzazione stanno in Impostazioni → Membri e Impostazioni → Generale; le modifiche al nome visualizzato del membro passano dalla rotta profilo di Better Auth e accettano da uno a cento caratteri.
Invita e accetta
POST /api/mobile/invitations invia per email un invito con ruolo admin, member o guest — solo owner e admin. I fallimenti tipizzati coprono alreadyMember, alreadyInvited, seatLimitExceeded, dailySendLimit e invalidInput, così l'interfaccia può spiegare ogni rifiuto. Reinvio e revoca vivono sulle rotte con id dell'invito, e il reinvio è soggetto a rate limit.
L'accettazione arriva tramite il deep link <scheme>://invite/<token>: l'app invia il token alla rotta di accettazione degli inviti, che restituisce l'id del workspace, attiva quel workspace e registra la preferenza lato server. Gli errori coprono expired, emailMismatch, not-pending e seat-limit-exceeded.
Cambia ruoli e rimuovi membri
PATCH /api/mobile/members/:userId assegna owner, admin, member o guest; DELETE rimuove un membro; POST /api/mobile/members/leave abbandona volontariamente. L'unico owner non può uscire né essere retrocesso, i membri non possono rimuovere se stessi tramite la rotta admin, e un cambio di ruolo che non altera nulla viene rifiutato anziché registrato.
Verifica e risoluzione dei problemi
Testa i limiti di posti, un link di invito revocato, le azioni ridotte del ruolo guest e il ritorno al workspace personale. La selezione in cache di un membro rimosso deve fallire chiusa alla richiesta successiva, non continuare a leggere il vecchio workspace.