Novo membro

Adicionar Membro ao Workspace

Adiciona um novo usuário como membro do workspace atual.

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
`email`	string	Sim	E-mail do usuário a ser adicionado
`type`	string	Sim	Tipo de membro: `full`, `standard` ou `viewer`
`role`	number	Não	ID do papel/cargo
`mgroups`	array	Não	IDs dos grupos aos quais o membro será vinculado (depreciado)
`fname`	string	Não	Primeiro nome do usuário a ser adicionado
`lname`	string	Não	Ultimo nome do usuário a ser adicionado
`v1_compatibility`	boolean	Não	Ativa compatibilidade com Interface v1

Validações de Tipo

owner: Apenas 1 permitido por workspace

viewer: (apenas visualização)

Modo Compatibilidade v1

Quando v1_compatibility=true:

✅ Tipos permitidos: full, standard

❌ Tipos bloqueados: owner, viewer

🔓 Member full terá acesso total (ignora role)

📋 Member standard será limitado apenas por grupos

Exemplo de Requisição

{
  "email": "novo.usuario@empresa.com",
  "type": "standard"
}

Resposta

Retorna o objeto do membro criado com status 201.

Comportamentos Especiais

Se o usuário não existir no sistema, será criado automaticamente

O usuário receberá um e-mail de convite para o workspace

Se já for membro, retorna erro 409 (conflito)

Códigos de Erro

400 - Dados inválidos ou tipo não permitido em modo v1

403 - Sem permissão para adicionar membros

409 - Usuário já é membro ou limite de owners excedido

422 - Role inválido ou grupos não existentes

curl --location --request POST 'https://api-develop.enspace.io/ws/members' \ --header 'Content-Type: application/json' \ --header 'x-api-key;' \ --header 'en-workspace;' \ --data-raw '{ "email": "rafaela.franco@bol.com.br", "fname": "Rafaela", "lname": "Franco", "type": "full" }'

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 Bodyapplication/json

string

requerido

Email do usuário

fname

string

opcional

Primeiro nome do usuário

lname

string

opcional

Ultímo nome do usuário

type

enum<string>

requerido

Tipo de membro no workspace

Valores permitidos:

fullstandardviewer

role

integer

opcional

ID de um cargo no workspace

>= 1

mgroups

array[integer]

opcional

Por facilitade, é possivel enviar um array com IDs de Grupos de membros em que o usuário será adicionado.

v1_compatibility

boolean

opcional

Envie, para compatibilidade com usuários acessando frontend v1.x.x

Examples

Respostas

🟢200OK

application/json

Membro adicionado com sucesso

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

Adicionar Membro ao Workspace#

Corpo da Requisição#

Validações de Tipo#

Modo Compatibilidade v1#

Exemplo de Requisição#

Resposta#

Comportamentos Especiais#

Códigos de Erro#

Requisição

Respostas

Adicionar Membro ao Workspace

Corpo da Requisição

Validações de Tipo

Modo Compatibilidade v1

Exemplo de Requisição

Resposta

Comportamentos Especiais

Códigos de Erro