Skip to main content
Ein Workspace teilt Apps mit anderen Square Cloud Benutzern, jeweils mit einer Rolle. api.workspaces verwaltet Workspaces, api.workspaces.members ihre Mitglieder und api.workspaces.apps die geteilten Apps. Das Erstellen von Workspaces erfordert einen Standard-, Pro- oder Enterprise-Plan. Die Beispiele verwenden den Client api aus Client erstellen. workspaceId ist die ID eines Workspace (workspaces.list() listet sie auf), appId die ID einer deiner Apps und memberId 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.inviteCode() 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 api.apps-Methode. workspaces.get() und workspaces.list() geben die reinen IDs zurück, also baue sie selbst:

Fehler

Außer workspaces.get() senden Workspace-Routen die IDs im Request-Body, daher ergibt eine leere ID dort 400 INVALID_ID vom Server, keinen lokalen Fehler.

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.