Atualizar membro

Atualizar Membro

Atualiza as informações de um membro existente no workspace.

Parâmetros

memberId (path) - ID do vínculo membro-workspace

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
`type`	string	Não	Novo tipo de membro
`role`	number	Não	Novo ID do papel/cargo
`status`	string	Não	Novo status (`active`, `inactive`, `blocked`)

Regras de Atualização de Tipo

De → Para	Permitido	Observações
owner → qualquer	❌	Owner não pode mudar de tipo
qualquer → owner	❌	Use endpoint específico de transferência
full ↔ standard	✅	-
viewer → full/standard	✅	-
full/standard → viewer	✅	-

Modo Compatibilidade v1

Quando v1_compatibility=true:

❌ Não permite alterar para tipos owner ou viewer

❌ Não permite atualizar membros tipo owner ou viewer

🔓 Tipo full ignora campo role

Exemplo de Requisição

{
  "type": "standard",
  "role": 5,
}

Resposta

Retorna o objeto do membro atualizado.

Observações

Apenas os campos enviados serão atualizados

Mudar status para inactive remove acesso mas mantém o vínculo

Permissões são recalculadas imediatamente após atualização

Códigos de Erro

400 - Tipo inválido ou não permitido em modo v1

403 - Sem permissão ou tentativa de alterar owner

422 - Role/grupos inválidos para o novo tipo

curl --location --request PUT 'https://api-develop.enspace.io/ws/members/' \ --header 'Content-Type: application/json' \ --header 'x-api-key;' \ --header 'en-workspace;' \ --data-raw '{ "type": "full", "status": "active", "role": 0 }'

{ "id": 0, "created_at": "string", "updated_at": "string", "user": { "id": 0, "created_at": "string", "email": "string", "meta": { "fname": "string", "lname": "string" } }, "email": "string", "type": "owner", "role": 0, "status": "active" }

Requisição

Authorization

API Key

Adicionar parâmetro em header

x-api-key

Exemplo:

x-api-key: ********************

API Key

Adicionar parâmetro em header

en-workspace

Exemplo:

en-workspace: ********************

Parâmetros Path

memberId

integer

requerido

Parâmetros Bodyapplication/json

type

enum<string>

opcional

Tipo de membro no workspace

Valores permitidos:

fullstandardviewer

status

enum<string>

opcional

Status do membro

Valores permitidos:

activependinginactiveblocked

role

integer

opcional

ID do cargo a ser atualizado.

Examples

Respostas

🟢200OK

application/json

Membro atualizado

Body

integer

requerido

ID do do registro

created_at

string

requerido

Data em que o registro foi criado

updated_at

string

requerido

Data da ultima atualizacao no registro

user

requerido

Usuário vinculado ao membro.

One of

User

integer

requerido

ID do do registro

created_at

string

requerido

Data em que o registro foi criado

string

requerido

Email do Usuário

Atualizar membro