Skip to main content
Un workspace condivide app con altri utenti di Square Cloud, ciascuno con un ruolo. api.workspaces gestisce i workspace, api.workspaces.members i loro membri e api.workspaces.apps le app condivise. La creazione di workspace richiede un piano Standard, Pro o Enterprise. Gli esempi usano il client api di Creare il client. workspaceId è l’id di un workspace (workspaces.list() li elenca), appId l’id di una delle tue app e memberId l’id di un membro.

Workspace

Il proprietario non può uscire (400 CANNOT_LEAVE_OWNER): elimina invece il workspace.

Membri

Per aggiungere un membro serve un codice di invito che il membro genera con members.inviteCode(). Il codice è valido per 5 minuti.
Ruoli (group): view, manager, maintain e admin. Chiamare un metodo che il tuo ruolo non consente produce 403 PERMISSION_DENIED.

Applicazioni condivise

Un workspace può contenere fino a 100 app (400 APPLICATIONS_LIMIT_REACHED).

Agire su un’app condivisa

Per agire su un’app condivisa con te, passa l’id composto <appId>-<workspaceId> a qualsiasi metodo di api.apps. workspaces.get() e workspaces.list() restituiscono gli id grezzi, quindi costruiscilo tu:

Errori

Tranne workspaces.get(), le route dei workspace inviano gli id nel body della richiesta, quindi un id vuoto lì produce 400 INVALID_ID dal server, non un errore locale.

Prossimi passi

AI

Chat completion tramite l’AI Gateway.

Riferimento API dei workspace

Gli endpoint REST dietro questi metodi.

Workspace dalla CLI

Le stesse azioni dal terminale.