Organization

Dernière mise à jour : 22 juin 2026

Une Organization est le conteneur de plus haut niveau qui regroupe les Space. Une entreprise ou une équipe correspond à une Organization, sous laquelle on place plusieurs Space. Le plan d'abonnement (plan) et les adhésions sont gérés au niveau de l'Organization : la facturation et les droits des membres s'appliquent donc à partir de cette Organization, et non du Space.

La liste des Organization auxquelles vous appartenez se récupère via GET /me/organization-memberships. Cette ressource ne dispose d'aucun endpoint renvoyant la liste complète.

Structure de la ressource

Voici la réponse d'une consultation unitaire de l'Organization "Société DailyWear". Elle possède sys (propriétés système) ainsi que les propriétés de corps name et 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": "Société DailyWear",
  "description": "Société exploitant une boutique en ligne de vêtements et accessoires"
}

Clés principales :

  • name : le nom de l'Organization (1 à 64 caractères). C'est le nom d'affichage de l'entreprise ou de l'équipe.
  • description : une description de l'Organization (1 à 128 caractères, facultatif).
  • plan : un Refer<Plan> désignant le plan d'abonnement de cette Organization (par exemple free). Le plan de facturation y est rattaché.
  • isOfficial : indique s'il s'agit d'une Organization officielle (boolean).

Propriétés système (sys) et corps

Toute Organization porte ses propriétés système communes dans l'objet sys. createdBy et updatedBy prennent la forme Refer ({ "sys": { "id", "type": "Refer", "targetType" } }), et plan est un Refer<Plan>.

PropriétéTypeDescription
idstringIdentifiant unique de la ressource.
typestringType de ressource. Pour une Organization, toujours "Organization".
createdByRefer<User>Utilisateur ayant créé la ressource.
createdAtstring (date-time)Date et heure de création.
updatedByRefer<User>Dernier utilisateur ayant modifié la ressource.
updatedAtstring (date-time)Date et heure de la dernière modification.
versioninteger (≥1)Version de la ressource. Augmente de 1 à chaque modification.
isOfficialbooleanIndique si l'Organization est officielle.
planRefer<Plan>Plan d'abonnement. Exemple : free.

Propriétés de corps :

PropriétéTypeDescription
namestring (1 à 64)Nom de l'Organization. Défini lors de la création et de la modification.
descriptionstring (1 à 128)Description de l'Organization. Élément facultatif.
iconstring (lecture) / object (écriture)Icône de l'Organization. Dans la réponse, il s'agit d'une chaîne d'URL d'image. Dans une requête de modification, on l'envoie sous forme d'objet désignant le fichier téléversé { "upload": { "sys": { ..., "targetType": "Upload" } } } (référence à l'Upload obtenu via l'API Upload).

L'Organization est une ressource de configuration sans notion de publication. Contrairement au Content et au Media, son sys ne comporte donc ni publish, ni archive, ni status : il ne possède que version. La version augmente à chaque modification de l'Organization.

API

L'URL de base de tous les endpoints ci-dessous est https://cma.weegloo.com/v1, et un token Bearer authentifiant auprès de CMA est requis dans l'en-tête Authorization. Pour les modifications et modifications partielles, il faut joindre l'en-tête X-Weegloo-Version (la sys.version actuelle de la ressource) afin d'assurer le contrôle de concurrence optimiste. La création et la suppression ne comportent pas cet en-tête.

  • Space : les Space sous cette Organization.
  • Organization Membership : membres de l'Organization et consultation des organisations dont vous faites partie.