---
title: "Replace a Person"
method: PUT
path: "/v1/people/{person-id}"
tags: ["People"]
---

# Replace a Person

`PUT /v1/people/{person-id}`

## Request

- Base URL: `https://api.sandbox.eu.ppro.com`
- URL: `https://api.sandbox.eu.ppro.com/v1/people/{person-id}`
- Auth: none required

## Path parameters

- `person-id` string, required: Unique identifier for the person

## Request body

- ReplacePersonRequest
  - `firstName` string, required: The legal given name of the person.
  - `lastName` string, required: The legal surname or family name of the person.
  - `middleName` string: An optional middle name of the person, if applicable.
  - `nativeName` string: The person’s name in their native script (e.g., Cyrillic, Kanji), if different from Latin characters.
  - `birthDate` string, date, required: The person’s birth date, in ISO-8601 format YYYY-MM-DD.
  - `address` Address, required
    - `street` string, required
    - `city` string, required
    - `region` string
    - `postalCode` string: Required for countries that use postal codes. This field can be omitted for the following country codes: AO,AI,AG,AW,BS,BZ,BJ,BM,BO,BQ,BW,CF,TD,KM,CG,CD,CK,CI,CW,DJ,DM,TL,GQ,ER,FJ,TF,GA,GM,GY,GD,HK,HM,IO,MO,MH,MS,NR,NU,NF,PW,PA,WS,KN,LC,VC,ST,SC,SL,SX,SB,SS,GS,SH,TC,TK,TO,TV,UG,AE,VA,VU,YE,ZW
    - `country` string, required: ISO 3166-1 alpha-2 Country Code
  - `email` string, email: An email address.

## Response `200`

Person replaced successfully

- PersonDetails: Person record with audit timestamps aligned to Entity .
  - `id` string, required: Unique identifier for the person
  - `externalPersonReference` string: Unique reference, assigned by external client.
  - `firstName` string, required: The legal given name of the person.
  - `lastName` string, required: The legal surname or family name of the person.
  - `middleName` string: An optional middle name of the person, if applicable.
  - `nativeName` string: The person’s name in their native script (e.g., Cyrillic, Kanji), if different from Latin characters.
  - `birthDate` string, date: The person’s birth date, in ISO-8601 format YYYY-MM-DD.
  - `address` Address, required
    - `street` string, required
    - `city` string, required
    - `region` string
    - `postalCode` string: Required for countries that use postal codes. This field can be omitted for the following country codes: AO,AI,AG,AW,BS,BZ,BJ,BM,BO,BQ,BW,CF,TD,KM,CG,CD,CK,CI,CW,DJ,DM,TL,GQ,ER,FJ,TF,GA,GM,GY,GD,HK,HM,IO,MO,MH,MS,NR,NU,NF,PW,PA,WS,KN,LC,VC,ST,SC,SL,SX,SB,SS,GS,SH,TC,TK,TO,TV,UG,AE,VA,VU,YE,ZW
    - `country` string, required: ISO 3166-1 alpha-2 Country Code
  - `email` string, email: An email address.
  - `createdAt` string, date-time, required: Timestamp when the resource was created. UTC timezone. Format YYYY-MM-DDTHH:MM:SS.ssssssZ
  - `updatedAt` string, date-time, required: Timestamp when the resource was last updated. UTC timezone. Format YYYY-MM-DDTHH:MM:SS.ssssssZ

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Resource not found
- `405`: Method not allowed
- `409`: Resource conflict
- `429`: Too many requests
- `500`: Internal Server Error
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/ppro/apis/onboarding.md) - [All operations](https://skmtc.dev/ppro/apis/onboarding/llms.txt) - [OpenAPI document](https://skmtc.dev/ppro/apis/onboarding/revisions/32c4db4523ac?raw)