API Docs Início Documentação Referência de API Copiar para LLM
PUT/v1/NaturalPerson/{id}
Crédito · Pessoas

Atualiza os dados de uma pessoa física

Atualiza por completo um registro de Natural Person existente.

Visão geral

Atualiza os dados de uma pessoa física. Observe que essa requisição pode excluir registros relacionados caso não sejam incluídos no corpo. Por exemplo, dados bancários e uploads não referênciados serão excluídos. Isso pode causar erros caso o dado bancário esteja relacionado à uma operação de crédito concluída ou em andamento. Neste caso, utilize a API específica de atualização de dados bancários. Essa atualização é ignorada se a coleção relacionada for informada com valor nulo.

Autenticação e pré-requisitos

Requer autenticação. Envie o token no header Authorization: Bearer {{token}} (JWT do AWS Cognito). Integrações servidor-a-servidor podem usar X-Api-Key. Todo tráfego é HTTPS e a credencial nunca vai na URL nem em query string.

Pré-requisitos: a rota exige identificador(es) de recurso já existente(s):

Request

Parâmetros

NomeEmTipoObrigatórioDescriçãoExemplo
idpathstring (uuid)obrigatório—3fa85f64-5717-4562-b3fc-2c963f66afa6
returnValuequerystringopcional—valor

Corpo da requisição

Envie no formato application/json. Corpo opcional.

Campos

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
phonestringobrigatório——"11987654321"
phoneExtensionstringopcional——"11987654321"
emailstringobrigatório——"cliente@exemplo.com.br"
namestringobrigatório——"Fulano de Tal"
nationalitystringopcional——"texto"
pepbooleanopcional——true
addressobjetoopcional—objeto — ver detalhe abaixo{ … }
birthDatestring (date-time)opcional——"2025-08-11T13:45:00Z"
civilStatusstringopcional—Married, Widowed, Separated, Divorced, Single"Married"
genderstringopcional—NotInformed, Male, Female"NotInformed"
documentTypestringopcional—RG, CPF, CNH, CTPS"RG"
documentNumberstringopcional——"texto"
documentIssuerstringopcional——"texto"
documentDatestring (date-time)opcional——"2025-08-11T13:45:00Z"
documentExpirationstring (date-time)opcional——"2025-08-11T13:45:00Z"
phone2stringopcional——"11987654321"
phone2Extensionstringopcional——"11987654321"
mothersNamestringopcional——"Fulano de Tal"
fathersNamestringopcional——"Fulano de Tal"
placeOfBirthCountrystringopcional——"texto"
placeOfBirthStatestringopcional——"texto"
typeOfResidencestringopcional—Owner, Rent"Owner"
between7And15YearsOldintegeropcional——0
upTo6YearsOldintegeropcional——0
over15YearsOldintegeropcional——0
workplacestringopcional——"texto"
workplaceCompanyRegistrationNumberstringopcional——"texto"
employeeNumberstringopcional——"texto"
occupationstringopcional——"texto"
natureOfOccupationstringopcional—PrivateEmployee, PublicEmployee, Employer, Capitalist, Military, Autonomous, Other"PrivateEmployee"
commercialPhonestringopcional——"11987654321"
commercialPhoneExtensionstringopcional——"11987654321"
netSalarynumber (double)opcional——1000
otherIncomenumber (double)opcional——1000
admissionDatestring (date-time)opcional——"2025-08-11T13:45:00Z"
commercialPhone2stringopcional——"11987654321"
commercialPhone2Extensionstringopcional——"11987654321"
commercialAddressobjetoopcional—objeto — ver detalhe abaixo{ … }
economicActivityCodeIdstring (uuid)opcional——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
spouseIndividualRegistrationNumberstringopcional——"texto"
spouseDocumentTypestringopcional—RG, CPF, CNH, CTPS"RG"
spouseDocumentNumberstringopcional——"texto"
spouseDocumentIssuerstringopcional——"texto"
spouseDocumentDatestring (date-time)opcional——"2025-08-11T13:45:00Z"
spouseDocumentExpirationstring (date-time)opcional——"2025-08-11T13:45:00Z"
spouseNamestringopcional——"Fulano de Tal"
spouseWorkplacestringopcional——"texto"
spouseOccupationstringopcional——"texto"
spouseCommercialPhonestringopcional——"11987654321"
spouseCommercialPhoneExtensionstringopcional——"11987654321"
spouseBirthDatestring (date-time)opcional——"2025-08-11T13:45:00Z"
spouseNetSalarynumber (double)opcional——1000
spouseOtherIncomenumber (double)opcional——1000
allowContactWhatsAppbooleanopcional——true
allowUpdatesWhatsAppbooleanopcional——true
assetsarray de objetoopcional—objeto — ver detalhe abaixo[ … ]
uploadsarray de objetoopcional—objeto — ver detalhe abaixo[ … ]
bankAccountsarray de objetoopcional—objeto — ver detalhe abaixo[ … ]
riskRatingstringopcional—Low, Intermediary, High"Low"
healthDeclarationstringopcionalDeclaração de Saúde—"texto"
departmentstringopcionalDepartamento—"texto"
socialNamestringopcionalNome Social—"Fulano de Tal"

Detalhe de ownerUser

CampoTipoObrigatórioDescriçãoValoresExemplo
userIdstringobrigatório——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
tenantNamestringobrigatório——"Fulano de Tal"

Detalhe de ownerGroup

CampoTipoObrigatórioDescriçãoValoresExemplo
groupIdstringobrigatório——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
tenantNamestringobrigatório——"Fulano de Tal"

Detalhe de address

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
addressNamestringobrigatório——"Fulano de Tal"
zipCodestringopcional——"01310930"
citystringobrigatório——"texto"
ufstringobrigatório—NaoSelecionado, AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG +14"NaoSelecionado"
districtstringobrigatório——"texto"
numberstringopcionalNúmero do endereço deve conter apenas números—"texto"
complementstringopcional——"texto"

Detalhe de assets

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
idstring (uuid)opcional——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
assetTypestringobrigatório—Cash, AccountsReceivable, Inventory, Investments, Vehicles, Furniture, Patents, RealEstate"Cash"
descriptionstringopcional——"texto"
registerNumberstringopcional——"texto"
estimatedValuenumber (double)opcional——1000
settledbooleanopcional——true

Detalhe de uploads

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
idstring (uuid)opcionalId do arquivo—"3fa85f64-5717-4562-b3fc-2c963f66afa6"
fileNamestringobrigatórioNome do arquivo (retornado pelo GET v1/Upload)—"Fulano de Tal"
fileTypestringopcional—Document, Authorization, DriversLicense, WorkCard, ResidenceProofCompany, ResidenceProofPartners, Draft, SocialContract, RegistrationNumber, IdentificationDocumentWithPhoto, BankStatement, ManagerialBilling, RegistrationForm, Others +41"Document"
displayNamestringopcionalNome de exibição do arquivo—"Fulano de Tal"
documentDatestring (date-time)opcionalData do próprio documento (emissão/referência), não a data do upload. Aceita em qualquer tipo de documento e sempre opcional. Só tem efeito de negócio no laudo de deferimento INSS e na última perícia INSS (regra de elegibilidade dos benefícios 32/92).—"2025-08-11T13:45:00Z"

Detalhe de bankAccounts

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
idstring (uuid)opcional——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
bankCodeintegeropcional——0
bankIspbinteger (int64)opcionalCódigo ISPB do banco—0
accountstringopcional——"texto"
accountDigitstringopcional——"texto"
agencystringopcional——"texto"
agencyDigitstringopcional——"texto"
typestringopcional—NaturalCheckingAccount, NaturalSimpleAccount, LegalCheckingAccount, PublicEntities, FinancialInstitutionsDeposits, NaturalSavingsAccount, LegalSavingsAccount, RealEstateSavingsAccount, LotteryDeposits, EscrowAccount"NaturalCheckingAccount"
jointAccountbooleanopcional——true
operationTypeValuestringobrigatório—Transfer, Pix"Transfer"
pixKeyTypeValuestringopcional—NaturalRegistrationNumber, LegalRegistrationNumber, Phone, Email, Automatic, AgencyAndAccount"NaturalRegistrationNumber"
keyPixstringopcionalChave Pix—"texto"

Exemplo de corpo

{
  "ownerUser": {
    "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "ownerGroup": {
    "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "phone": "11987654321",
  "phoneExtension": "11987654321",
  "email": "cliente@exemplo.com.br",
  "name": "Fulano de Tal",
  "nationality": "texto",
  "pep": true,
  "address": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "birthDate": "2025-08-11T13:45:00Z",
  "civilStatus": "Married",
  "gender": "NotInformed",
  "documentType": "RG",
  "documentNumber": "texto",
  "documentIssuer": "texto",
  "documentDate": "2025-08-11T13:45:00Z",
  "documentExpiration": "2025-08-11T13:45:00Z",
  "phone2": "11987654321",
  "phone2Extension": "11987654321",
  "mothersName": "Fulano de Tal",
  "fathersName": "Fulano de Tal",
  "placeOfBirthCountry": "texto",
  "placeOfBirthState": "texto",
  "typeOfResidence": "Owner",
  "between7And15YearsOld": 0,
  "upTo6YearsOld": 0,
  "over15YearsOld": 0,
  "workplace": "texto",
  "workplaceCompanyRegistrationNumber": "texto",
  "employeeNumber": "texto",
  "occupation": "texto",
  "natureOfOccupation": "PrivateEmployee",
  "commercialPhone": "11987654321",
  "commercialPhoneExtension": "11987654321",
  "netSalary": 1000,
  "otherIncome": 1000,
  "admissionDate": "2025-08-11T13:45:00Z",
  "commercialPhone2": "11987654321",
  "commercialPhone2Extension": "11987654321",
  "commercialAddress": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "economicActivityCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "spouseIndividualRegistrationNumber": "texto",
  "spouseDocumentType": "RG",
  "spouseDocumentNumber": "texto",
  "spouseDocumentIssuer": "texto",
  "spouseDocumentDate": "2025-08-11T13:45:00Z",
  "spouseDocumentExpiration": "2025-08-11T13:45:00Z",
  "spouseName": "Fulano de Tal",
  "spouseWorkplace": "texto",
  "spouseOccupation": "texto",
  "spouseCommercialPhone": "11987654321",
  "spouseCommercialPhoneExtension": "11987654321",
  "spouseBirthDate": "2025-08-11T13:45:00Z",
  "spouseNetSalary": 1000,
  "spouseOtherIncome": 1000,
  "allowContactWhatsApp": true,
  "allowUpdatesWhatsApp": true,
  "assets": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "assetType": "Cash",
      "description": "texto",
      "registerNumber": "texto",
      "estimatedValue": 1000,
      "settled": true
    }
  ],
  "uploads": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "fileName": "Fulano de Tal",
      "fileType": "Document",
      "displayName": "Fulano de Tal",
      "documentDate": "2025-08-11T13:45:00Z"
    }
  ],
  "bankAccounts": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "bankCode": 0,
      "bankIspb": 0,
      "account": "texto",
      "accountDigit": "texto",
      "agency": "texto",
      "agencyDigit": "texto",
      "type": "NaturalCheckingAccount",
      "jointAccount": true,
      "operationTypeValue": "Transfer",
      "pixKeyTypeValue": "NaturalRegistrationNumber",
      "keyPix": "texto"
    }
  ],
  "riskRating": "Low",
  "healthDeclaration": "texto",
  "department": "texto",
  "socialName": "Fulano de Tal"
}

Response

Resposta 200 sem corpo (Success).

Códigos de retorno

CódigoSignificadoDetalhe do contrato
200Requisição bem-sucedida.Success

Exemplos

curl -X PUT "{{baseUrl}}/v1/NaturalPerson/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "ownerUser": {
    "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "ownerGroup": {
    "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "phone": "11987654321",
  "phoneExtension": "11987654321",
  "email": "cliente@exemplo.com.br",
  "name": "Fulano de Tal",
  "nationality": "texto",
  "pep": true,
  "address": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "birthDate": "2025-08-11T13:45:00Z",
  "civilStatus": "Married",
  "gender": "NotInformed",
  "documentType": "RG",
  "documentNumber": "texto",
  "documentIssuer": "texto",
  "documentDate": "2025-08-11T13:45:00Z",
  "documentExpiration": "2025-08-11T13:45:00Z",
  "phone2": "11987654321",
  "phone2Extension": "11987654321",
  "mothersName": "Fulano de Tal",
  "fathersName": "Fulano de Tal",
  "placeOfBirthCountry": "texto",
  "placeOfBirthState": "texto",
  "typeOfResidence": "Owner",
  "between7And15YearsOld": 0,
  "upTo6YearsOld": 0,
  "over15YearsOld": 0,
  "workplace": "texto",
  "workplaceCompanyRegistrationNumber": "texto",
  "employeeNumber": "texto",
  "occupation": "texto",
  "natureOfOccupation": "PrivateEmployee",
  "commercialPhone": "11987654321",
  "commercialPhoneExtension": "11987654321",
  "netSalary": 1000,
  "otherIncome": 1000,
  "admissionDate": "2025-08-11T13:45:00Z",
  "commercialPhone2": "11987654321",
  "commercialPhone2Extension": "11987654321",
  "commercialAddress": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "economicActivityCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "spouseIndividualRegistrationNumber": "texto",
  "spouseDocumentType": "RG",
  "spouseDocumentNumber": "texto",
  "spouseDocumentIssuer": "texto",
  "spouseDocumentDate": "2025-08-11T13:45:00Z",
  "spouseDocumentExpiration": "2025-08-11T13:45:00Z",
  "spouseName": "Fulano de Tal",
  "spouseWorkplace": "texto",
  "spouseOccupation": "texto",
  "spouseCommercialPhone": "11987654321",
  "spouseCommercialPhoneExtension": "11987654321",
  "spouseBirthDate": "2025-08-11T13:45:00Z",
  "spouseNetSalary": 1000,
  "spouseOtherIncome": 1000,
  "allowContactWhatsApp": true,
  "allowUpdatesWhatsApp": true,
  "assets": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "assetType": "Cash",
      "description": "texto",
      "registerNumber": "texto",
      "estimatedValue": 1000,
      "settled": true
    }
  ],
  "uploads": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "fileName": "Fulano de Tal",
      "fileType": "Document",
      "displayName": "Fulano de Tal",
      "documentDate": "2025-08-11T13:45:00Z"
    }
  ],
  "bankAccounts": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "bankCode": 0,
      "bankIspb": 0,
      "account": "texto",
      "accountDigit": "texto",
      "agency": "texto",
      "agencyDigit": "texto",
      "type": "NaturalCheckingAccount",
      "jointAccount": true,
      "operationTypeValue": "Transfer",
      "pixKeyTypeValue": "NaturalRegistrationNumber",
      "keyPix": "texto"
    }
  ],
  "riskRating": "Low",
  "healthDeclaration": "texto",
  "department": "texto",
  "socialName": "Fulano de Tal"
}'
var baseUrl = "{{baseUrl}}";
var token   = "{{token}}";

using var http = new HttpClient { BaseAddress = new Uri(baseUrl) };
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", token);

var rota = "/v1/NaturalPerson/3fa85f64-5717-4562-b3fc-2c963f66afa6";

var corpo = new StringContent(
    """
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "phone": "11987654321",
      "phoneExtension": "11987654321",
      "email": "cliente@exemplo.com.br",
      "name": "Fulano de Tal",
      "nationality": "texto",
      "pep": true,
      "address": {
        "ownerUser": {
          "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "tenantName": "Fulano de Tal"
        },
        "ownerGroup": {
          "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "tenantName": "Fulano de Tal"
        },
        "addressName": "Fulano de Tal",
        "zipCode": "01310930",
        "city": "texto",
        "uf": "NaoSelecionado",
        "district": "texto",
        "number": "texto",
        "complement": "texto"
      },
      "birthDate": "2025-08-11T13:45:00Z",
      "civilStatus": "Married",
      "gender": "NotInformed",
      "documentType": "RG",
      "documentNumber": "texto",
      "documentIssuer": "texto",
      "documentDate": "2025-08-11T13:45:00Z",
      "documentExpiration": "2025-08-11T13:45:00Z",
      "phone2": "11987654321",
      "phone2Extension": "11987654321",
      "mothersName": "Fulano de Tal",
      "fathersName": "Fulano de Tal",
      "placeOfBirthCountry": "texto",
      "placeOfBirthState": "texto",
      "typeOfResidence": "Owner",
      "between7And15YearsOld": 0,
      "upTo6YearsOld": 0,
      "over15YearsOld": 0,
      "workplace": "texto",
      "workplaceCompanyRegistrationNumber": "texto",
      "employeeNumber": "texto",
      "occupation": "texto",
      "natureOfOccupation": "PrivateEmployee",
      "commercialPhone": "11987654321",
      "commercialPhoneExtension": "11987654321",
      "netSalary": 1000,
      "otherIncome": 1000,
      "admissionDate": "2025-08-11T13:45:00Z",
      "commercialPhone2": "11987654321",
      "commercialPhone2Extension": "11987654321",
      "commercialAddress": {
        "ownerUser": {
          "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "tenantName": "Fulano de Tal"
        },
        "ownerGroup": {
          "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "tenantName": "Fulano de Tal"
        },
        "addressName": "Fulano de Tal",
        "zipCode": "01310930",
        "city": "texto",
        "uf": "NaoSelecionado",
        "district": "texto",
        "number": "texto",
        "complement": "texto"
      },
      "economicActivityCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "spouseIndividualRegistrationNumber": "texto",
      "spouseDocumentType": "RG",
      "spouseDocumentNumber": "texto",
      "spouseDocumentIssuer": "texto",
      "spouseDocumentDate": "2025-08-11T13:45:00Z",
      "spouseDocumentExpiration": "2025-08-11T13:45:00Z",
      "spouseName": "Fulano de Tal",
      "spouseWorkplace": "texto",
      "spouseOccupation": "texto",
      "spouseCommercialPhone": "11987654321",
      "spouseCommercialPhoneExtension": "11987654321",
      "spouseBirthDate": "2025-08-11T13:45:00Z",
      "spouseNetSalary": 1000,
      "spouseOtherIncome": 1000,
      "allowContactWhatsApp": true,
      "allowUpdatesWhatsApp": true,
      "assets": [
        {
          "ownerUser": {
            "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "ownerGroup": {
            "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "assetType": "Cash",
          "description": "texto",
          "registerNumber": "texto",
          "estimatedValue": 1000,
          "settled": true
        }
      ],
      "uploads": [
        {
          "ownerUser": {
            "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "ownerGroup": {
            "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "fileName": "Fulano de Tal",
          "fileType": "Document",
          "displayName": "Fulano de Tal",
          "documentDate": "2025-08-11T13:45:00Z"
        }
      ],
      "bankAccounts": [
        {
          "ownerUser": {
            "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "ownerGroup": {
            "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "bankCode": 0,
          "bankIspb": 0,
          "account": "texto",
          "accountDigit": "texto",
          "agency": "texto",
          "agencyDigit": "texto",
          "type": "NaturalCheckingAccount",
          "jointAccount": true,
          "operationTypeValue": "Transfer",
          "pixKeyTypeValue": "NaturalRegistrationNumber",
          "keyPix": "texto"
        }
      ],
      "riskRating": "Low",
      "healthDeclaration": "texto",
      "department": "texto",
      "socialName": "Fulano de Tal"
    }
    """,
    Encoding.UTF8, "application/json");

var resp = await http.PutAsync(rota, corpo);
resp.EnsureSuccessStatusCode();
// Sem corpo de resposta neste endpoint.
const baseUrl = '{{baseUrl}}';
const token   = '{{token}}';

const payload = {
  "ownerUser": {
    "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "ownerGroup": {
    "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "phone": "11987654321",
  "phoneExtension": "11987654321",
  "email": "cliente@exemplo.com.br",
  "name": "Fulano de Tal",
  "nationality": "texto",
  "pep": true,
  "address": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "birthDate": "2025-08-11T13:45:00Z",
  "civilStatus": "Married",
  "gender": "NotInformed",
  "documentType": "RG",
  "documentNumber": "texto",
  "documentIssuer": "texto",
  "documentDate": "2025-08-11T13:45:00Z",
  "documentExpiration": "2025-08-11T13:45:00Z",
  "phone2": "11987654321",
  "phone2Extension": "11987654321",
  "mothersName": "Fulano de Tal",
  "fathersName": "Fulano de Tal",
  "placeOfBirthCountry": "texto",
  "placeOfBirthState": "texto",
  "typeOfResidence": "Owner",
  "between7And15YearsOld": 0,
  "upTo6YearsOld": 0,
  "over15YearsOld": 0,
  "workplace": "texto",
  "workplaceCompanyRegistrationNumber": "texto",
  "employeeNumber": "texto",
  "occupation": "texto",
  "natureOfOccupation": "PrivateEmployee",
  "commercialPhone": "11987654321",
  "commercialPhoneExtension": "11987654321",
  "netSalary": 1000,
  "otherIncome": 1000,
  "admissionDate": "2025-08-11T13:45:00Z",
  "commercialPhone2": "11987654321",
  "commercialPhone2Extension": "11987654321",
  "commercialAddress": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "economicActivityCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "spouseIndividualRegistrationNumber": "texto",
  "spouseDocumentType": "RG",
  "spouseDocumentNumber": "texto",
  "spouseDocumentIssuer": "texto",
  "spouseDocumentDate": "2025-08-11T13:45:00Z",
  "spouseDocumentExpiration": "2025-08-11T13:45:00Z",
  "spouseName": "Fulano de Tal",
  "spouseWorkplace": "texto",
  "spouseOccupation": "texto",
  "spouseCommercialPhone": "11987654321",
  "spouseCommercialPhoneExtension": "11987654321",
  "spouseBirthDate": "2025-08-11T13:45:00Z",
  "spouseNetSalary": 1000,
  "spouseOtherIncome": 1000,
  "allowContactWhatsApp": true,
  "allowUpdatesWhatsApp": true,
  "assets": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "assetType": "Cash",
      "description": "texto",
      "registerNumber": "texto",
      "estimatedValue": 1000,
      "settled": true
    }
  ],
  "uploads": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "fileName": "Fulano de Tal",
      "fileType": "Document",
      "displayName": "Fulano de Tal",
      "documentDate": "2025-08-11T13:45:00Z"
    }
  ],
  "bankAccounts": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "bankCode": 0,
      "bankIspb": 0,
      "account": "texto",
      "accountDigit": "texto",
      "agency": "texto",
      "agencyDigit": "texto",
      "type": "NaturalCheckingAccount",
      "jointAccount": true,
      "operationTypeValue": "Transfer",
      "pixKeyTypeValue": "NaturalRegistrationNumber",
      "keyPix": "texto"
    }
  ],
  "riskRating": "Low",
  "healthDeclaration": "texto",
  "department": "texto",
  "socialName": "Fulano de Tal"
};

const resp = await fetch(`${baseUrl}/v1/NaturalPerson/3fa85f64-5717-4562-b3fc-2c963f66afa6`, {
  method: 'PUT',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload),
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
// Sem corpo de resposta neste endpoint.

Troque apenas {{baseUrl}} e {{token}}. No Postman, defina-os como variáveis de environment; o cURL importa em Import > Raw text.

Downloads

Este endpoint já vem configurado nas collections abaixo, na pasta da etapa correspondente.

Collection completaConsignado privado e FGTS, em pastas espelhando a documentação.Baixar →Collection do Consignado privadoCadastros, operação e consultas do módulo.Baixar →Collection do FGTSCadastros, operação e consultas do módulo.Baixar →Environment do PostmanAs variáveis fora da collection, para versionar uma sem versionar o token.Baixar →Documentação consolidada para LLMToda a documentação em um arquivo de texto, na ordem da navegação.Baixar →Referência em MarkdownEste contrato, campo a campo, gerado do spec.Baixar →

Guia de importação: Como importar no Postman · Todos os downloads: Downloads