Atualiza um usuário (parcial) — e liga/desliga o acesso dele aos seus parceiros
PATCH
/api/v1/users/{user_uuid}
name, phone e status. email/cpf são imutáveis. Atualização de group_id está fora do escopo dessa versão.status age nos seus parceiros, não no cadastro
status liga (ACTIVE) ou desliga (INACTIVE) o acesso do usuário ao parceiro do token e a todos os sub-parceiros abaixo dele — na prática, a situação dos vínculos (partners[].status). O cadastro do usuário não é apagado nem bloqueado na plataforma, e os vínculos com parceiros fora da sua hierarquia continuam como estavam: um usuário que também opera em outra rede segue operando nela.{ "status": "INACTIVE" }status: "ACTIVE" é como se desfaz um DELETE — o DELETE desliga exatamente os mesmos vínculos. O usuário volta com o mesmo user_uuid, o mesmo grupo e o mesmo histórico; recriá-lo do zero não é equivalente, geraria outro user_uuid.200 e não muda nada.user_uuid que nunca existiu continua respondendo 404.{"status": "ACTIVE", "phone": "11999998888"}.ACTIVE religa todos os vínculos do usuário na sua hierarquia, inclusive os que tenham sido desligados um a um por PUT /api/v1/partners/{partner_id}/users/{user_id}/status/INACTIVE. Para mexer em um parceiro só, use aquele endpoint.status na resposta — sai INACTIVE quando o usuário não opera em nenhum parceiro. Se ele ainda tem vínculo ativo em outra hierarquia, continua ACTIVE; a situação parceiro a parceiro está em partners[].status.Requisição
Parâmetros de Caminho
Parâmetros Header
Parâmetros Bodyapplication/jsonNecessário
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request PATCH 'https://gtw.unnotech.com.br/public/api/v1/users/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"status": "ACTIVE"
}'Response Response Example
200 - Exemplo 1
{
"data": {
"user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
"name": "string",
"email": "string",
"phone": "string",
"cpf": "string",
"status": "ACTIVE",
"partners": [
{
"group": {
"slug": "gerente-corban",
"label": "GERENTE CORBAN",
"group_id": "c57d9d45-552c-4c02-870e-f086cb09c57d"
},
"status": "ACTIVE",
"partner_id": "6a3a39f6-861b-4a48-b868-5de838400e06",
"partner_name": "string"
}
],
"must_change_password": true,
"created_at": "2019-08-24T14:15:22.123Z"
}
}Modificado em 2026-09-01 17:32:17