Organization

Eine Organization ist der oberste Container, der Spaces aufnimmt. Ein Unternehmen oder Team entspricht einer Organization, unter der mehrere Spaces angelegt werden. Da das Abonnement (plan) und die Mitgliedschaften auf Ebene der Organization verwaltet werden, gelten Abrechnung und Mitgliederberechtigungen nicht auf Ebene des Space, sondern bezogen auf diese Organization.

Die Liste der Organizations, denen Sie angehören, rufen Sie über GET /me/organization-memberships ab. Diese Ressource bietet keinen Endpunkt, der die vollständige Liste zurückgibt.

Ressourcenstruktur

Im Folgenden sehen Sie die Antwort einer Einzelabfrage der Organization "DailyWear Company". Sie besitzt sys (Systemattribute) sowie die inhaltlichen Attribute name und description.

{
  "sys": {
    "id": "ilLRJxDp",
    "type": "Organization",
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-05-11T10:51:16.832Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-05-11T10:51:16.832Z",
    "version": 1,
    "isOfficial": false,
    "plan": { "sys": { "id": "free", "type": "Refer", "targetType": "Plan" } }
  },
  "name": "DailyWear Company",
  "description": "Unternehmen, das einen Online-Shop für Kleidung und Accessoires betreibt"
}

Wichtigste Schlüssel:

• name: Der Name der Organization (1 bis 64 Zeichen). Der Anzeigename des Unternehmens oder Teams.
• description: Eine Beschreibung der Organization (1 bis 128 Zeichen, optional).
• plan: Ein Refer<Plan>, der auf das Abonnement dieser Organization verweist (z. B. free). Der Abrechnungsplan ist hier verknüpft.
• isOfficial: Gibt an, ob es sich um eine offizielle Organization handelt (boolean).

Systemattribute (sys) und Inhalt

Jede Organization führt ihre gemeinsamen Systemattribute im Objekt sys. createdBy und updatedBy liegen in der Refer-Form ({ "sys": { "id", "type": "Refer", "targetType" } }) vor, und plan ist ein Refer<Plan>.

Inhaltliche Attribute:

Eine Organization ist eine Konfigurationsressource ohne Veröffentlichungskonzept. Anders als Content und Media besitzt sie daher in sys kein publish, archive oder status, sondern nur version. version erhöht sich bei jeder Änderung der Organization.

Das Ändern (PUT) ersetzt die gesamte Ressource, wobei ein nicht gesendeter Wert bei den beiden optionalen Attributen genau die entgegengesetzte Bedeutung hat. Lassen Sie icon weg, bleibt das bestehende Symbol erhalten; lassen Sie dagegen consoleHomeUrl weg, wird die gespeicherte Adresse gelöscht. Um eine bereits angegebene Adresse zu behalten, müssen Sie diesen Wert bei jeder Änderung mitsenden. Das Teiländern (PATCH) berührt nur die im Patch genannten Attribute und lässt consoleHomeUrl daher unverändert, solange Sie es nicht angeben.

Bedingungen für die Seite, die als Startseite erscheint

Eine gespeicherte Adresse bedeutet nicht, dass die Seite auch angezeigt wird. Auch wenn Sie eine Adresse angeben, die ihre Anzeige verweigert, ist die Speicheranfrage erfolgreich und es wird kein Fehler zurückgegeben; es zeigt sich allein daran, dass auf der Startseite nichts erscheint.

Damit die Seite an dieser Stelle angezeigt wird, muss die Seite selbst Folgendes erfüllen.

• Sie wird über HTTPS bereitgestellt. Die Konsole läuft über HTTPS, daher blockiert der Browser die Anzeige einer Seite ohne gesicherte Verbindung.
• Sie erlaubt die Anzeige innerhalb einer anderen Seite. Geben Sie im Antwort-Header Content-Security-Policy: frame-ancestors https://console.weegloo.com an. Falls X-Frame-Options die Anzeige blockiert, passen Sie diesen Header ebenfalls an.
• Wenn sie Cookies verwendet, stellt sie diese mit SameSite=None; Secure aus. Die Seite wird im Kontext einer anderen Website angezeigt, daher wird ein Cookie ohne diese Angabe nicht übertragen.

Die Seite wird innerhalb eines <iframe> angezeigt, und für diesen Frame sind nur die folgenden Berechtigungen freigegeben.

Was hier nicht aufgeführt ist, funktioniert nicht. Dabei tritt kein Fehler auf und der Aufruf wird stillschweigend ignoriert, sodass der Code nicht erkennen kann, ob er blockiert wurde.

Für den Frame wird zusätzlich referrerpolicy="strict-origin-when-cross-origin" gesetzt. Dadurch erhält die Seite nur die Herkunft der Konsole, nicht jedoch die Information, von welchem Bildschirm aus sie geöffnet wurde.

Unabhängig von sandbox funktioniert eine Seite, die eine Anmeldung erfordert, möglicherweise nicht richtig. Viele Anmeldedienste blockieren die Anmeldung innerhalb einer anderen Seite, daher funktioniert Social Login in der Regel nicht.

Fehler

Dies sind die Codes, die beim Umgang mit einer Organization auftreten. Codes, die allen Ressourcen gemeinsam sind, finden Sie unter Gemeinsame Fehler.

API

Die Basis-URL aller folgenden Endpunkte lautet https://cma.weegloo.com/v1, und der Header Authorization muss ein Bearer-Token zur Authentifizierung gegenüber CMA enthalten. Beim Ändern und Teiländern müssen Sie für die optimistische Nebenläufigkeitskontrolle zusätzlich den Header X-Weegloo-Version (die aktuelle sys.version der Ressource) senden. Beim Erstellen und Löschen entfällt dieser Header.

Verwandte Dokumente

• Space: Der Space unter dieser Organization.
• Organization Membership: Mitglieder der Organization und Abfrage der eigenen Organisationszugehörigkeit.