Skip to main content
Un workspace partage des applications avec d’autres utilisateurs de Square Cloud, chacun avec un rôle. client.workspaces gère les workspaces, client.workspaces.members leurs membres et client.workspaces.apps les applications partagées. La création de workspaces nécessite un plan Standard, Pro ou Enterprise. Les exemples utilisent le client présenté dans Créer le client. workspace_id est l’identifiant d’un workspace (workspaces.list() les liste), app_id celui de l’une de vos applications et member_id 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.invite_code(). 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 client.apps. workspaces.get() et workspaces.list() renvoient les identifiants bruts : construisez-le donc vous-même :

Erreurs

Les routes de workspace envoient les identifiants dans le corps de la requête : un identifiant vide donne donc 400 INVALID_ID renvoyé par le serveur (et non une erreur locale). L’exception est workspaces.get(), dont l’identifiant se trouve dans le chemin de l’URL : un identifiant vide y échoue localement.

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.