Painel da empresa › Usuários
Editar usuário
PATCH/api/v1/users/{id}Pede sessãoComo funciona
Edita nome, papel, cargo e situação de uma pessoa do painel. O corpo é o mesmo da criação, com todos os campos.
Trocar o e-mail não vale na hora: o endereço novo recebe um link de confirmação (válido por 1 hora), e só depois de confirmar ele passa a ser o login. Até lá, a lista mostra o e-mail novo em pendingEmail.
Fica na trilha de auditoria. Pede a permissão de criar e editar usuários.
Parâmetros
idCaminho · string · obrigatórioIdentificador do registro, como vem na listagem.emailCorpo · stringE-mail.jobTitleCorpo · stringCargo, só para exibição.nameCorpo · stringNome.roleCorpo · stringPapel na empresa: `admin`, `coordenador`, `escalista` ou `hospital`.statusCorpo · stringSituação.profileIdCorpo · stringPerfil de Permissões escolhido no campo Permissão (id de `GET /permissions`). Ausente: não mexe; vazio: volta ao perfil nativo do papel. Perfil sem papel (Suporte, Operacional) precisa vir aqui.companyIdsCorpo · string[]Acesso por empresa: as empresas cadastradas (de `GET /me/registered-companies`) que o usuário pode ver, cada uma com todas as escalas dela. Ausente: não mexe; vazia: todas. Empresa de outro cliente dá 400. O filtro é do servidor: médicos, escalas, calendário, vagas, check-in, trocas, antecipações, folha, contratos, contas, mensagens dos médicos e as contagens do menu só trazem o que é das escalas dessas empresas; registro de fora, pedido pelo id, responde como não encontrado. Pagar a folha de médico com plantão fora do acesso dá 403, e o mesmo vale para mexer pelo id em ponto, plantão, jornada, troca, candidatura ou faturamento de escala fora do acesso, ou mandar no corpo escala, jornada ou plantão de fora (criar plantão, jornada ou troca, valores e faturamento do contrato, médico na escala).
Respostas
200 · message: diz se houve confirmação de e-mail enviada.
messagestring · Mensagem para mostrar à pessoa.
Corpo de exemplo
{
"message": "texto"
}