Space Membership

Space Membership es el registro que indica con qué SpaceRole pertenece un usuario a un determinado Space. Un mismo usuario puede pertenecer a varios Space y tener permisos distintos en cada uno, de modo que cada combinación de usuario, Space y permisos se corresponde con un único Space Membership. A diferencia de Organization Membership, que incorpora a una persona nueva invitándola por correo electrónico, Space Membership añade un usuario ya existente mediante la referencia user y le otorga permisos con roles (un array de referencias a SpaceRole). No es una invitación por correo electrónico.

La lista de Space a los que perteneces se consulta con GET /me/space-memberships. Si envías además include=1, la respuesta incluye también el detalle del Space al que apunta.

Estructura del recurso

A continuación se muestra la respuesta de la consulta individual de un Space Membership. En sys (propiedades del sistema) figuran el usuario (user) y el Space (space) a los que apunta esta membresía, y como propiedad del cuerpo lleva el conjunto de permisos (roles).

{
  "sys": {
    "id": "3trmXRLdJF4GBlAjtcuoWfVunfJ8uV",
    "type": "SpaceMembership",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "user": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-14T14:56:04.737Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-14T14:56:04.737Z",
    "version": 1
  },
  "roles": [
    { "sys": { "id": "3trmXRLdJF4GBlAjtcuoWfVubsasp4", "type": "Refer", "targetType": "SpaceRole" } }
  ]
}

Claves principales:

• space: el Refer<Space> que apunta al Space al que pertenece esta membresía.
• user: el Refer<User> que apunta al usuario de esta membresía. El usuario que se añade como miembro queda vinculado aquí.
• roles: el conjunto de permisos que tiene este usuario en el Space. Es un array de Refer<SpaceRole> que apunta a SpaceRole, y un mismo miembro puede tener varios SpaceRole a la vez.

Propiedades del sistema (sys) y cuerpo

Todo Space Membership incluye las propiedades comunes del sistema en el objeto sys. space, user, createdBy y updatedBy figuran con la forma Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Propiedades del cuerpo:

Space 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 dispone de version. 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 contra CMA en la cabecera Authorization. Para modificar los roles (PUT, PATCH) hay que enviar además la cabecera X-Weegloo-Version (el sys.version actual del recurso) para el control de concurrencia optimista. La adición (creación) y la eliminación de miembros no llevan esta cabecera.

Documentos relacionados

• SpaceRole: definición del SpaceRole (conjunto de permisos) que se incluye en roles.
• Space: el Space al que pertenece esta membresía.
• Organization Membership: miembros y roles a nivel de Organization.