Skip to main content
Un workspace partage des applications avec d’autres utilisateurs de Square Cloud, chacun avec un rôle. api.workspaces gère les workspaces, api.workspaces.members leurs membres et api.workspaces.apps les applications partagées. La création de workspaces nécessite un plan Standard, Pro ou Enterprise. Les exemples utilisent le client api présenté dans Créer le client. workspaceId est l’identifiant d’un workspace (workspaces.list() les liste), appId celui de l’une de vos applications et memberId l’id d’un membre.

Workspaces

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(). Le code est valable 5 minutes.
Rôles (group) : view, manager, maintain et admin. 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 api.apps. workspaces.get() et workspaces.list() renvoient les identifiants bruts : construisez-le donc vous-même :

Erreurs

À l’exception de workspaces.get(), les routes de workspace 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).

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.