Skip to main content
Un workspace partage des applications avec d’autres utilisateurs de Square Cloud, chacun avec un rôle. c.Workspaces gère les workspaces, c.Workspaces.Members leurs membres et c.Workspaces.Apps les applications partagées. La création de workspaces nécessite un plan Standard, Pro ou Enterprise. Chaque extrait ci-dessous s’exécute seul dans ce programme : collez-en un à la fois dans main et lancez goimports (voir Exécuter les exemples).

Workspaces

Workspaces.List(ctx) renvoie tous les workspaces dont vous êtes propriétaire ou membre, avec les mêmes champs :
Pour quitter un workspace en tant que membre, ou le supprimer en tant que propriétaire :
Le propriétaire ne peut pas quitter le workspace (400 CANNOT_LEAVE_OWNER) : supprimez plutôt le workspace.

Membres

L’ajout d’un membre nécessite un code d’invitation que le membre génère avec Members.InviteCode(ctx). Le code est valable 5 minutes.
Pour changer le rôle d’un membre ou le retirer, passez son ID obtenu avec Workspaces.Get :
Rôles (WorkspaceGroup) : GroupView (view), GroupManager (manager), GroupMaintain (maintain) et GroupAdmin (admin). Le Group d’un membre est une simple string, car il peut aussi valoir "owner". Appeler une méthode que votre rôle n’autorise pas donne 403 PERMISSION_DENIED.

Applications partagées

Un workspace peut contenir jusqu’à 100 applications (400 APPLICATIONS_LIMIT_REACHED).

Agir sur une application partagée

Pour agir sur une application partagée avec vous, passez l’identifiant composite <appId>-<workspaceId> à n’importe quelle méthode de c.Apps. Workspaces.Get et Workspaces.List renvoient les identifiants bruts : construisez-le donc vous-même :

Erreurs

Les routes de workspace autres que Get envoient les identifiants dans le corps de la requête : un identifiant vide y donne donc 400 INVALID_ID renvoyé par le serveur (et non une erreur locale). Get envoie l’identifiant dans le chemin : un identifiant vide échoue donc localement avec INVALID_ID (statut 0).

Prochaines étapes

IA

Des chat completions via l’AI Gateway.

Référence de l'API des workspaces

Les endpoints REST derrière ces méthodes.

Workspaces depuis la CLI

Les mêmes actions depuis le terminal.