Space Membership

Space Membership é o registro que indica a qual Space um usuário pertence e com quais SpaceRoles. Como um mesmo usuário pode pertencer a vários Spaces, e as permissões podem variar de Space para Space, cada combinação de usuário, Space e permissões corresponde a um Space Membership. Diferentemente de Organization Membership, que convida uma pessoa nova por e-mail, Space Membership adiciona um usuário já existente por meio da referência user e concede permissões com roles (um array de referências a SpaceRole). Não é um convite por e-mail.

A lista de Spaces a que você pertence é consultada por GET /me/space-memberships. Se você enviar include=1 junto, os detalhes do Space apontado também são incluídos na resposta.

Estrutura do recurso

A seguir está a resposta de consulta individual de um Space Membership. Em sys (propriedades de sistema) ficam o usuário (user) e o Space (space) que essa associação aponta, e como propriedade de corpo ela tem o conjunto de permissões (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" } }
  ]
}

Chaves principais:

• space: um Refer<Space> que aponta para o Space a que essa associação pertence.
• user: um Refer<User> que aponta para o usuário dessa associação. O usuário adicionado como membro fica vinculado aqui.
• roles: o conjunto de permissões que esse usuário tem no Space. É um array de Refer<SpaceRole> que aponta para SpaceRoles, e um membro pode ter vários SpaceRoles ao mesmo tempo.

Propriedades de sistema (sys) e corpo

Todo Space Membership mantém as propriedades de sistema comuns no objeto sys. space, user, createdBy e updatedBy entram no formato Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Propriedades de corpo:

Space Membership é um recurso de configuração que não tem o conceito de publicação. Por isso, ao contrário de Content e Media, ele não tem publish, archive nem status em sys, apenas version. O version aumenta a cada alteração da associação.

API

A URL base de todos os endpoints abaixo é https://cma.weegloo.com/v1, e o cabeçalho Authorization requer um token Bearer que autentica na CMA. Para alterar papéis (PUT e PATCH), é preciso enviar também o cabeçalho X-Weegloo-Version (o sys.version atual do recurso) para controle de concorrência otimista. Adicionar membro (criação) e excluir não usam esse cabeçalho.

Documentos relacionados

• SpaceRole: a definição do SpaceRole (conjunto de permissões) que entra em roles.
• Space: o Space a que essa associação pertence.
• Organization Membership: membros e papéis no nível da Organization.