Skip to main content
Un workspace condivide app con altri utenti di Square Cloud, ciascuno con un ruolo. client.workspaces gestisce i workspace, client.workspaces.members i loro membri e client.workspaces.apps le app condivise. La creazione di workspace richiede un piano Standard, Pro o Enterprise. Gli esempi usano il client di Creare il client. workspace_id è l’id di un workspace (workspaces.list() li elenca), app_id l’id di una delle tue app e member_id 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.invite_code(). 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 client.apps. workspaces.get() e workspaces.list() restituiscono gli id grezzi, quindi costruiscilo tu:

Errori

Le route dei workspace inviano gli id nel body della richiesta, quindi un id vuoto produce 400 INVALID_ID dal server (non un errore locale). L’eccezione è workspaces.get(), il cui id è nel percorso dell’URL: lì un id vuoto fallisce localmente.

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.