# Usuários

Este conjunto de recursos oferece funcionalidades completas para a administração dos dados dos usuários:

        *   **Cadastrar Usuário:**
            *   Cria um novo registro de usuário no sistema.
        *   **Listar Usuários:**
            *   Obtenha listas de usuários cadastrados, com opções de filtragem por nome, empresa, perfil, tipo de pessoa, setor e paginação. É possível listar também apenas usuários ativos.
        *   **Listar Agentes:**
            *   Obtenha listas de agentes cadastrados, com opções de filtragem por paginação.
        *   **Listar Visão Carteira Agentes:**
            *   Obtenha lista da visão carteira do agente.
        *   **Recuperar Usuário por ID:**
            *   Recupere os dados detalhados de um usuário específico utilizando seu identificador.
        *   **Alterar Usuário:**
            *   Atualiza as informações cadastrais de um usuário existente.
        *   **Manipular Perfis de Usuário:**
            *   Adiciona ou remove perfis atribuídos a um usuário.
        *   **Alterar Preferências do Usuário:**
            *   Modifica as configurações de preferências individuais de um usuário.
        *   **Alterar Imagem do Usuário:**
            *   Permite a atualização da imagem de perfil do usuário.
        *   **Excluir Usuário:**
            *   Remove um registro de usuário do sistema.
        *   **Verificar Existência de Usuário:**
            *   Verifica a existência de um usuário pelo CPF e/ou login.

## Recuperar um usuário

 - [GET /api/v1/usuarios/{id}](https://apidocs.ger26.com.br/apis/acessos/v1/usuarios/paths/~1api~1v1~1usuarios~1%7Bid%7D/get.md): Recupera os dados de um usuário específico pelo ID.

## Alterar usuário

 - [PUT /api/v1/usuarios/{id}](https://apidocs.ger26.com.br/apis/acessos/v1/usuarios/paths/~1api~1v1~1usuarios~1%7Bid%7D/put.md): Realiza a alteração dos dados de um usuário.

## Excluir usuário

 - [DELETE /api/v1/usuarios/{id}](https://apidocs.ger26.com.br/apis/acessos/v1/usuarios/paths/~1api~1v1~1usuarios~1%7Bid%7D/delete.md): Exclui um usuário do sistema com base no ID.

## Listar usuários ativos

 - [GET /api/v1/usuarios/ativos](https://apidocs.ger26.com.br/apis/acessos/v1/usuarios/paths/~1api~1v1~1usuarios~1ativos/get.md): Lista os usuários ativos do sistema.

## Listar usuários

 - [GET /api/v1/usuarios](https://apidocs.ger26.com.br/apis/acessos/v1/usuarios/paths/~1api~1v1~1usuarios/get.md): Lista os usuários cadastrados no sistema com filtros opcionais.

## Cadastrar usuário

 - [POST /api/v1/usuarios](https://apidocs.ger26.com.br/apis/acessos/v1/usuarios/paths/~1api~1v1~1usuarios/post.md): Cadastra um novo usuário para acesso ao sistema.

## Listar agentes

 - [GET /api/v1/agentes/{id}/usuarios](https://apidocs.ger26.com.br/apis/acessos/v1/usuarios/paths/~1api~1v1~1agentes~1%7Bid%7D~1usuarios/get.md): Lista os agentes cadastrados no sistema com filtros opcionais.

## Listar visão carteira do agente

 - [GET /api/v1/agentes/{id}/usuarios-visao-carteira](https://apidocs.ger26.com.br/apis/acessos/v1/usuarios/paths/~1api~1v1~1agentes~1%7Bid%7D~1usuarios-visao-carteira/get.md): Listar cedentes que o agente tem permissão para enxergar

## Manipular perfis de usuário

 - [PATCH /api/v1/usuarios/manipular-perfis](https://apidocs.ger26.com.br/apis/acessos/v1/usuarios/paths/~1api~1v1~1usuarios~1manipular-perfis/patch.md): Manipula os perfis atribuídos a um usuário.

## Alterar preferências do usuário

 - [PATCH /api/v1/usuarios/{id}/preferencias](https://apidocs.ger26.com.br/apis/acessos/v1/usuarios/paths/~1api~1v1~1usuarios~1%7Bid%7D~1preferencias/patch.md): Realiza a alteração das preferências do usuário.

## Alterar imagem do usuário

 - [PATCH /api/v1/usuarios/{id}/imagem](https://apidocs.ger26.com.br/apis/acessos/v1/usuarios/paths/~1api~1v1~1usuarios~1%7Bid%7D~1imagem/patch.md): Realiza a alteração da imagem de perfil do usuário.

## Verificar existência de usuário

 - [GET /api/v1/usuarios/verificar](https://apidocs.ger26.com.br/apis/acessos/v1/usuarios/paths/~1api~1v1~1usuarios~1verificar/get.md): Verifica se existe um usuário com o CPF informado e/ou com o CPF e login informados.