1. Usuários
Docs Unnotech
  • Visão geral da API
  • Guia: Originação FGTS
  • Guia: Originação CLT
  • Guia: Quota diária
  • Changelog e avisos de mudança
  • Autenticação
    • Gera um access_token
      POST
  • Originação
    • FGTS
      • Busca applications pelo id externo do consumidor
      • Cria uma solicitação (application) e dispara a cotação
      • Status enxuto da application (para polling)
      • Detalha uma application pelo id
      • Re-cota uma application (ofertas antigas invalidadas)
      • Lê o KYC (pré-preenchido quando disponível na plataforma)
      • Submete o KYC (cadastro completo) exigido antes do aceite
      • Aceita uma oferta e inicia a contratação
    • CLT
      • Busca solicitações pelo id externo do consumidor
      • Cria uma solicitação (application) de consignado CLT
      • Status enxuto da solicitação (para polling)
      • Detalha uma solicitação pelo id
      • Consulta o consentimento do trabalhador
      • Força uma nova verificação do consentimento
      • Consulta a margem consignável por vínculo
      • Simula e monta o menu de ofertas
      • Completa o cadastro do cliente
      • Lê o KYC (pré-preenchido quando disponível)
      • Submete o KYC exigido antes do aceite
      • Aceita uma oferta e inicia a contratação
  • Propostas
    • Lista propostas com filtros e paginação
      GET
    • Detalha uma proposta pelo UUID
      GET
  • Admin
    • Usuários
      • Lista usuários com filtros e paginação
        GET
      • Cadastra um novo usuário
        POST
      • Remove o usuário dos seus parceiros
        DELETE
      • Detalha um usuário pelo UUID
        GET
      • Atualiza um usuário (parcial) — e liga/desliga o acesso dele aos seus parceiros
        PATCH
    • Parceiros
      • Lista parceiros com filtros e paginação
      • Cadastra um novo parceiro
      • Detalha um parceiro pelo UUID
      • Remove um parceiro
      • Atualiza um parceiro (parcial)
      • Ativa ou inativa um usuário dentro do parceiro
    • Grupos
      • Lista grupos disponíveis
  • Esquemas
    • CreateUserRequest
    • CreateUserResponse
    • UserDetail
    • Data
    • CreateUserResponseData
    • BankerizeErrorResponse
    • UserPartnerEntry
    • Address
    • BankAccount
    • CreatePartnerRequest
    • Partner
    • Pix
    • CreatePartnerResponse
    • CreatePartnerResponseData
    • Customer
    • ApiError
    • ApiErrorResponse
    • CreateFgtsApplicationRequest
    • ErrorDetail
    • FieldErrorCode
    • ApiErrorCode
    • ApplicationStatus
    • FgtsInstallment
    • FgtsQuote
    • OfferStatus
    • FgtsApplication
    • QuoteStatus
    • RejectionKind
    • FgtsOffer
    • RejectionReason
    • AcceptFgtsOfferRequest
    • AcceptFgtsOfferResponse
    • AccountType
    • CivilStatus
    • DisbursementMethod
    • FgtsKyc
    • FgtsKycAddress
    • FgtsKycBank
    • Gender
    • PixKeyType
    • TokenRequest
    • TokenResponse
    • CltCustomer
    • OAuth2ErrorResponse
    • AuthorizationStatus
    • Group
    • UserDetailResponse
    • CreateCltApplicationRequest
    • CltCustomerCompleteness
    • UpdatePartnerRequest
    • CltApplication
    • CltEmploymentAlert
    • CltAuthorization
    • CltInstallment
    • PartnerDetail
    • PartnerDetailResponse
    • PageInfo
    • CltEmployment
    • CltQuote
    • SortInfo
    • CltSimulation
    • CustomerField
    • CltIneligibilityReason
    • UsersPage
    • CltOffer
    • ProposalsPage
    • AcceptCltOfferRequest
    • PublicProposalListItem
    • PublicCustomerSummary
    • QuoteBasis
    • AcceptCltOfferResponse
    • PublicDisbursementAccount
    • CltSimulationRequest
    • OfferNotice
    • PublicLoanSummary
    • CltKycAddress
    • CltKycBank
    • PublicProposalDetailResponse
    • CltKyc
    • PartnerListItem
    • PartnersPage
    • ListOfGroupsResponse
    • CltKycEmployer
    • FgtsApplicationList
    • FgtsApplicationStatus
    • UpdateUserRequest
    • UpdateCltCustomerRequest
    • UserListItem
    • PublicProposalDetail
    • CltApplicationList
    • CltApplicationStatus
    • CltMargin
  1. Usuários

Remove o usuário dos seus parceiros

DELETE
/api/v1/users/{user_uuid}
Remove o acesso do usuário ao parceiro do token e a todos os sub-parceiros abaixo dele, inativando cada vínculo dessa hierarquia.
O cadastro do usuário não é apagado: ele continua existindo, visível no GET e na listagem, e os vínculos com parceiros fora da sua hierarquia continuam intactos — um usuário que também opera em outra rede segue operando nela.

O que muda no usuário#

Cada vínculo sob a sua hierarquia fica com partners[].status = INACTIVE.
O usuário perde o acesso a esses parceiros já na requisição seguinte (o token dele é invalidado do outro lado), sem esperar o token expirar.
O cadastro na plataforma não é bloqueado nem apagado: um usuário que também opera em parceiros de outra hierarquia continua operando lá.
O status do usuário passa a sair INACTIVE nas consultas quando ele não tem mais nenhum vínculo ativo — em nenhum parceiro, dentro ou fora da sua hierarquia.

Idempotência#

Repetir a chamada devolve 204 sem efeito: vínculo já inativo não é reprocessado. Se o usuário não tem nenhum vínculo ativo na sua hierarquia, a resposta também é 204.

Como devolver o acesso#

PATCH /api/v1/users/{user_uuid} com {"status": "ACTIVE"} religa os vínculos do usuário na sua hierarquia — é o inverso exato desta operação. Para devolver o acesso a um parceiro só, use PUT /api/v1/partners/{partner_id}/users/{user_id}/status/ACTIVE.

Equivale a PATCH com status: INACTIVE#

As duas operações escrevem a mesma coisa. Use o DELETE quando a intenção é só tirar o usuário da sua rede; use o PATCH quando a mudança de situação vem junto de outros campos.

Requisição

Authorization
JWT Bearer
Adicionar o parâmetro
Authorization
a Cabeçalhos
Exemplo:
Authorization: ********************
or
Parâmetros de Caminho

Parâmetros Header

Respostas

🟢204Sem Conteúdo
Vínculos da hierarquia do chamador inativados (ou já estavam).
Esta resposta não possui corpo.
🟠401Não Autorizado
🟠403Proibido
🟠404Registo Não Encontrado
🔴500Erro do Servidor
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request DELETE 'https://gtw.unnotech.com.br/public/api/v1/users/' \
--header 'Authorization: Bearer <token>'
Modificado em 2026-09-01 17:32:17
Página anterior
Cadastra um novo usuário
Próxima página
Detalha um usuário pelo UUID
Built with