Skip to main content
Ein Workspace teilt Apps mit anderen Square Cloud Benutzern, jeweils mit einer Rolle. client.workspaces verwaltet Workspaces, client.workspaces.members ihre Mitglieder und client.workspaces.apps die geteilten Apps. Das Erstellen von Workspaces erfordert einen Standard-, Pro- oder Enterprise-Plan. Die Beispiele verwenden den client aus Client erstellen. workspace_id ist die ID eines Workspace (workspaces.list() listet sie auf), app_id die ID einer deiner Apps und member_id die id eines Mitglieds.

Workspaces

Der Eigentümer kann den Workspace nicht verlassen (400 CANNOT_LEAVE_OWNER): Lösche den Workspace stattdessen.

Mitglieder

Zum Hinzufügen eines Mitglieds ist ein Einladungscode nötig, den das Mitglied mit members.invite_code() erzeugt. Der Code ist 5 Minuten gültig.
Rollen (group): view, manager, maintain und admin. Der Aufruf einer Methode, die deine Rolle nicht erlaubt, ergibt 403 PERMISSION_DENIED.

Geteilte Anwendungen

Ein Workspace kann bis zu 100 Apps enthalten (400 APPLICATIONS_LIMIT_REACHED).

Auf eine geteilte App zugreifen

Um auf eine mit dir geteilte App zuzugreifen, übergib die zusammengesetzte ID <appId>-<workspaceId> an eine beliebige client.apps-Methode. workspaces.get() und workspaces.list() geben die reinen IDs zurück, also baue sie selbst:

Fehler

Workspace-Routen senden die IDs im Request-Body, daher ergibt eine leere ID 400 INVALID_ID vom Server (keinen lokalen Fehler). Die Ausnahme ist workspaces.get(), dessen ID im URL-Pfad steht: Dort schlägt eine leere ID lokal fehl.

Nächste Schritte

KI

Chat Completions über das AI Gateway.

API-Referenz für Workspaces

Die REST-Endpunkte hinter diesen Methoden.

Workspaces über die CLI

Dieselben Aktionen im Terminal.