Organization Membership

Organization Membership es el registro que indica a qué Organization pertenece una persona y con qué permiso (role). Una persona puede pertenecer a varias Organization, y el permiso puede ser distinto en cada Organization, de modo que cada combinación de persona, organización y permiso corresponde a una Organization Membership. Los nuevos miembros se agregan invitándolos por correo electrónico (endpoint Invitar (crear) más abajo). Al crear la invitación, la persona de ese correo electrónico se une a la Organization con ese role.

La lista de Organization a las que pertenezco se consulta con GET /me/organization-memberships. Si se envía además include=1, la respuesta también incluye el detalle de la Organization referenciada.

Estructura del recurso

A continuación se muestra la respuesta de consulta individual de una Organization Membership. En sys (propiedades del sistema) van la persona (user) y la organización (organization) a las que apunta esta membresía, y como propiedad de cuerpo tiene el permiso (role).

{
  "sys": {
    "id": "3trmXRL6dW1QKblBXOc8nXAVz4kPXd",
    "type": "OrganizationMembership",
    "organization": { "sys": { "id": "ilLRJxDp", "type": "Refer", "targetType": "Organization" } },
    "user": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-05-11T10:51:16.841Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-05-11T10:51:16.841Z",
    "version": 1
  },
  "role": "OWNER"
}

Claves principales:

• organization: el Refer<Organization> que apunta a la Organization a la que pertenece esta membresía.
• user: el Refer<User> que apunta a la persona de esta membresía. Cuando la persona invitada se une, ese usuario queda vinculado aquí.
• role: el nivel de permiso que tiene esta persona en la Organization. Es uno de OWNER, ADMIN o MEMBER.

Propiedades del sistema (sys) y cuerpo

Toda Organization Membership lleva las propiedades del sistema comunes en el objeto sys. organization, user, createdBy y updatedBy van con forma Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Propiedades de cuerpo:

Los tres valores de role significan lo siguiente:

• OWNER: nivel de propietario de la Organization.
• ADMIN: nivel de administrador de la Organization.
• MEMBER: nivel de miembro ordinario de la Organization.

Organization Membership 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 tiene version. La version aumenta cada vez que se modifica la membresía.

API

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

Documentos relacionados

• Organization: la Organization a la que apunta esta membresía.
• Space Membership: miembros y roles a nivel de Space.