Organization

Última actualización: 22 de junio de 2026

Una Organization es el contenedor de nivel superior que agrupa Spaces. Una empresa o un equipo corresponde a una Organization, y bajo ella se ubican varios Spaces. El plan de suscripción (plan) y la membresía se gestionan a nivel de Organization, por lo que la facturación y los permisos de los miembros se aplican según esta Organization, no según el Space.

La lista de Organizations a las que perteneces se consulta mediante GET /me/organization-memberships. Este recurso no dispone de un endpoint que devuelva la lista completa.

Estructura del recurso

A continuación se muestra la respuesta de consulta individual de la Organization "DailyWear Compañía". Tiene sys (propiedades del sistema) y las propiedades del cuerpo name y 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 Compañía",
  "description": "Empresa que gestiona una tienda en línea de ropa y accesorios"
}

Claves principales:

  • name: el nombre de la Organization (de 1 a 64 caracteres). Es el nombre visible de la empresa o el equipo.
  • description: una descripción de la Organization (de 1 a 128 caracteres, opcional).
  • plan: un Refer<Plan> que apunta al plan de suscripción de esta Organization (por ejemplo, free). El plan de facturación está vinculado aquí.
  • isOfficial: indica si es una Organization oficial (boolean).

Propiedades del sistema (sys) y cuerpo

Toda Organization incluye sus propiedades del sistema comunes en el objeto sys. createdBy y updatedBy se incluyen con la forma Refer ({ "sys": { "id", "type": "Refer", "targetType" } }), y plan es un Refer<Plan>.

PropiedadTipoDescripción
idstringIdentificador único del recurso.
typestringTipo de recurso. Para una Organization siempre es "Organization".
createdByRefer<User>Usuario que lo creó.
createdAtstring (date-time)Fecha y hora de creación.
updatedByRefer<User>Último usuario que lo modificó.
updatedAtstring (date-time)Fecha y hora de la última modificación.
versioninteger (≥1)Versión del recurso. Aumenta en 1 cada vez que se modifica.
isOfficialbooleanIndica si la Organization es oficial.
planRefer<Plan>Plan de suscripción. Por ejemplo: free.

Propiedades del cuerpo:

PropiedadTipoDescripción
namestring (1~64)Nombre de la Organization. Se indica al crear y al modificar.
descriptionstring (1~128)Descripción de la Organization. Es un campo opcional.
iconstring (lectura) / object (escritura)Icono de la Organization. En la respuesta es una cadena con la URL de la imagen. En la solicitud de modificación se envía como un objeto que apunta al archivo subido { "upload": { "sys": { ..., "targetType": "Upload" } } } (referencia al Upload obtenido mediante la API de Upload).

Una Organization es un recurso de configuración sin concepto de publicación. Por eso, a diferencia de Content y Media, su sys no tiene publish, archive ni status, y solo dispone de version. El campo version aumenta cada vez que se modifica la Organization.

API

La URL base de todos los endpoints siguientes es https://cma.weegloo.com/v1, y se requiere un token Bearer que autentique en CMA en la cabecera Authorization. Las modificaciones y las modificaciones parciales requieren enviar además la cabecera X-Weegloo-Version (el sys.version actual del recurso) para el control de concurrencia optimista. La creación y la eliminación no llevan esta cabecera.

  • Space: el Space bajo esta Organization.
  • Organization Membership: consulta de los miembros de la Organization y de las organizaciones a las que perteneces.