Usuários

5. Usuários#

POST/v1/users#

Cria um novo usuário na empresa.

Auth: Owner

Request:

json
{
  "email": "agente@empresa.com",
  "name": "Maria Souza",
  "password": "Senha1234",
  "role": "agent"
}
Campo Tipo Obrigatório Descricao
email string sim Email único
name string sim Nome do usuário
password string sim Senha (mínimo 8 caracteres)
role string não owner, admin ou agent. Padrão: agent

Resposta 201:

json
{
  "user_id": 3,
  "email": "agente@empresa.com",
  "role": "agent"
}

GET/v1/users#

Lista todos os usuários da empresa.

Auth: Owner

Resposta 200:

json
[
  {
    "id": 1,
    "email": "dono@empresa.com",
    "name": "Joao Silva",
    "role": "owner"
  },
  {
    "id": 3,
    "email": "agente@empresa.com",
    "name": "Maria Souza",
    "role": "agent"
  }
]

PATCH/v1/users/{userId}/role#

Altera o role de um usuário.

Auth: Owner

Request:

json
{
  "role": "admin"
}

Resposta 200:

json
{
  "user_id": 3,
  "role": "admin",
  "message": "role updated"
}