PATCH Atualizar Roles do Usuário
Define as roles do usuário na clínica. É uma substituição total: as roles que não estiverem em rolesIds são removidas e as enviadas são atribuídas.
Autenticação necessária
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Permissão necessária
Exige a permissão give_roles.
Substituição, não incremento
Enviar rolesIds vazio (ou omitido) remove todas as roles do usuário. Os valores são slugs das roles da clínica; veja Listar Roles da Conta.
Endpoint
PATCH https://api-dev.imagemais.com.br/api/users/roles
Corpo da Requisição
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID do usuário |
rolesIds | string[] | ❌ | Slugs das roles (ex.: org-recepcao) a atribuir. Vazio remove todas |
Requisição
curl -X 'PATCH' \n 'https://api-dev.imagemais.com.br/api/users/roles' \n -H 'accept: application/json' \n -H 'Authorization: Bearer {accessToken}' \n -H 'Content-Type: application/json' \n -d '{
"id": 12,
"rolesIds": [
"org-recepcao"
]
}'
Respostas
200 Sucesso
{
"success": true
}
400 Usuário sem acesso pelo novo login
{
"message": "Esse usuário ainda não tem acesso pelo novo login.",
"error": "Bad Request",
"statusCode": 400
}
404 Não encontrado
Mensagens possíveis: Usuário não encontrado e Role não encontrada.
{
"message": "Usuário não encontrado",
"error": "Not Found",
"statusCode": 404
}
403 Sem permissão
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}
503 Serviço de login indisponível
{
"message": "Não foi possível falar com o serviço de login. Tente novamente em instantes.",
"error": "Service Unavailable",
"statusCode": 503
}