Usuários e sessão
Mudar usuário
PATCH/v1/usuarios/{usuario_id}
Muda o papel ou desativa um usuário. Só administrador.
Parâmetros
| Nome | Onde | Tipo | Obrigatório | Descrição |
|---|---|---|---|---|
usuario_id |
caminho | uuid | sim | Id do usuário |
Corpo (application/json)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ativo |
booleano | não | false desativa o acesso |
papel |
administrador | operador | financeiro |
não | administrador, operador ou financeiro |
Respostas
| HTTP | Significa |
|---|---|
| 200 | OK |
| 422 | Corpo ou parâmetros com formato inválido (detail lista os campos) |
Erros
Recusas vêm como {"detail": {"erro": "<código>", "mensagem": "…"}}.
| HTTP | erro |
Significa |
|---|---|---|
| 401 | — | Chave ausente ou inválida |
| 404 | nao_encontrado |
Usuário não encontrado nesta Conta |