Organization

Zuletzt aktualisiert: 22. Juni 2026

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>.

AttributTypBeschreibung
idstringEindeutige Kennung der Ressource.
typestringArt der Ressource. Für eine Organization immer "Organization".
createdByRefer<User>Benutzer, der die Ressource erstellt hat.
createdAtstring (date-time)Zeitpunkt der Erstellung.
updatedByRefer<User>Benutzer, der die Ressource zuletzt geändert hat.
updatedAtstring (date-time)Zeitpunkt der letzten Änderung.
versioninteger (≥1)Version der Ressource. Erhöht sich bei jeder Änderung um 1.
isOfficialbooleanGibt an, ob die Organization offiziell ist.
planRefer<Plan>Abonnement. Beispiel: free.

Inhaltliche Attribute:

AttributTypBeschreibung
namestring (1 bis 64)Name der Organization. Wird beim Erstellen und Ändern angegeben.
descriptionstring (1 bis 128)Beschreibung der Organization. Optionales Attribut.
iconstring (lesend) / object (schreibend)Symbol der Organization. In der Antwort eine Zeichenkette mit der Bild-URL. In der Änderungsanfrage als Objekt gesendet, das auf die hochgeladene Datei verweist: { "upload": { "sys": { ..., "targetType": "Upload" } } } (Verweis auf das über die Upload API erhaltene Upload).

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.

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.

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