Skip to main content
PUT
Replace a person
This endpoint performs a full replacement of a person record using HTTP PUT semantics. All fields are overwritten with the values you provide, and the addresses array is replaced in its entirety – any address entries not included in the new payload will be removed. Use this endpoint to correct identity data, update a person’s name after a legal change, or refresh address history with a new current address. To update only specific fields, retrieve the current person first using the Retrieve person endpoint, make your changes to the returned payload, and submit the complete updated object to this endpoint.
This is a full replacement operation. The addresses array is replaced entirely – omitting an existing address entry will permanently remove it. Always retrieve the current person record before calling this endpoint to avoid data loss.
Updating a person’s identity data does not automatically trigger a new KYC check. If you update core identity fields (such as name or date of birth) for a person who is already associated with an approved merchant, contact Tilta to determine whether re-verification is required.

Authorizations

Authorization
string
header
required

Your Tilta API key, sent as Bearer <key>.

Path Parameters

external_id
string
required

Unique identifier of a person.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$

Body

application/json
salutation
enum<string> | null
required

Person salutation. Send null to clear.

Available options:
MR,
MS,
OTHER
first_name
string
required

Person first name.

last_name
string
required

Person last name.

birth_date
number | null
required

Person date of birth. Send null to clear.

email
string<email> | null
required

Person email. Send null to clear.

phone
string | null
required

Person phone number (+491711010101). Send null to clear.

Example:

"+491711010101"

is_fatca
boolean | null
required

Is the person a US taxpayer under FATCA reporting obligations? Send null to clear.

is_pep
boolean | null
required

Is the person a Politically Exposed person (PEP)? Send null to clear.

tax_id
string | null
required

Person tax ID. Send null to clear.

citizenship
enum<string>[] | null
required

Person citizenship. Send null or [] to clear.

Available options:
AF,
AL,
DZ,
AS,
AD,
AO,
AI,
AQ,
AG,
AR,
AM,
AW,
AU,
AT,
AZ,
BS,
BH,
BD,
BB,
BY,
BE,
BZ,
BJ,
BM,
BT,
BO,
BQ,
BA,
BW,
BV,
BR,
IO,
BN,
BG,
BF,
BI,
CV,
KH,
CM,
CA,
KY,
CF,
TD,
CL,
CN,
CX,
CC,
CO,
KM,
CD,
CG,
CK,
CR,
HR,
CU,
CW,
CY,
CZ,
CI,
DK,
DJ,
DM,
DO,
EC,
EG,
SV,
GQ,
ER,
EE,
SZ,
ET,
FK,
FO,
FJ,
FI,
FR,
GF,
PF,
TF,
GA,
GM,
GE,
DE,
GH,
GI,
GR,
GL,
GD,
GP,
GU,
GT,
GG,
GN,
GW,
GY,
HT,
HM,
VA,
HN,
HK,
HU,
IS,
IN,
ID,
IR,
IQ,
IE,
IM,
IL,
IT,
JM,
JP,
JE,
JO,
KZ,
KE,
KI,
KP,
KR,
KW,
KG,
LA,
LV,
LB,
LS,
LR,
LY,
LI,
LT,
LU,
MO,
MG,
MW,
MY,
MV,
ML,
MT,
MH,
MQ,
MR,
MU,
YT,
MX,
FM,
MD,
MC,
MN,
ME,
MS,
MA,
MZ,
MM,
NA,
NR,
NP,
NL,
NC,
NZ,
NI,
NE,
NG,
NU,
NF,
MK,
MP,
NO,
OM,
PK,
PW,
PS,
PA,
PG,
PY,
PE,
PH,
PN,
PL,
PT,
PR,
QA,
RO,
RU,
RW,
RE,
BL,
SH,
KN,
LC,
MF,
PM,
VC,
WS,
SM,
ST,
SA,
SN,
RS,
SC,
SL,
SG,
SX,
SK,
SI,
SB,
SO,
ZA,
GS,
SS,
ES,
LK,
SD,
SR,
SJ,
SE,
CH,
SY,
TW,
TJ,
TZ,
TH,
TL,
TG,
TK,
TO,
TT,
TN,
TM,
TC,
TV,
TR,
UG,
UA,
AE,
GB,
UM,
US,
UY,
UZ,
VU,
VE,
VN,
VG,
VI,
WF,
EH,
YE,
ZM,
ZW,
AX
addresses
object[]
required

Person's addresses. Replaces the existing set entirely. Send [] to clear all stored addresses.

Response

The person has been successfully updated.

external_id
string
required

Unique identifier of a person.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
first_name
string
required

Person first name.

last_name
string
required

Person last name.

salutation
enum<string> | null

Person salutation.

Available options:
MR,
MS,
OTHER
birth_date
number | null

Person date of birth.

email
string<email> | null

Person email.

phone
string | null

Person phone number. (+491711010101)

Example:

"+491711010101"

is_fatca
boolean | null

Is the person a US taxpayer under FATCA reporting obligations?

is_pep
boolean | null

Is the person a Politically Exposed person (PEP)?

tax_id
string | null

Person tax ID.

citizenship
enum<string>[] | null

Person citizenship.

Available options:
AF,
AL,
DZ,
AS,
AD,
AO,
AI,
AQ,
AG,
AR,
AM,
AW,
AU,
AT,
AZ,
BS,
BH,
BD,
BB,
BY,
BE,
BZ,
BJ,
BM,
BT,
BO,
BQ,
BA,
BW,
BV,
BR,
IO,
BN,
BG,
BF,
BI,
CV,
KH,
CM,
CA,
KY,
CF,
TD,
CL,
CN,
CX,
CC,
CO,
KM,
CD,
CG,
CK,
CR,
HR,
CU,
CW,
CY,
CZ,
CI,
DK,
DJ,
DM,
DO,
EC,
EG,
SV,
GQ,
ER,
EE,
SZ,
ET,
FK,
FO,
FJ,
FI,
FR,
GF,
PF,
TF,
GA,
GM,
GE,
DE,
GH,
GI,
GR,
GL,
GD,
GP,
GU,
GT,
GG,
GN,
GW,
GY,
HT,
HM,
VA,
HN,
HK,
HU,
IS,
IN,
ID,
IR,
IQ,
IE,
IM,
IL,
IT,
JM,
JP,
JE,
JO,
KZ,
KE,
KI,
KP,
KR,
KW,
KG,
LA,
LV,
LB,
LS,
LR,
LY,
LI,
LT,
LU,
MO,
MG,
MW,
MY,
MV,
ML,
MT,
MH,
MQ,
MR,
MU,
YT,
MX,
FM,
MD,
MC,
MN,
ME,
MS,
MA,
MZ,
MM,
NA,
NR,
NP,
NL,
NC,
NZ,
NI,
NE,
NG,
NU,
NF,
MK,
MP,
NO,
OM,
PK,
PW,
PS,
PA,
PG,
PY,
PE,
PH,
PN,
PL,
PT,
PR,
QA,
RO,
RU,
RW,
RE,
BL,
SH,
KN,
LC,
MF,
PM,
VC,
WS,
SM,
ST,
SA,
SN,
RS,
SC,
SL,
SG,
SX,
SK,
SI,
SB,
SO,
ZA,
GS,
SS,
ES,
LK,
SD,
SR,
SJ,
SE,
CH,
SY,
TW,
TJ,
TZ,
TH,
TL,
TG,
TK,
TO,
TT,
TN,
TM,
TC,
TV,
TR,
UG,
UA,
AE,
GB,
UM,
US,
UY,
UZ,
VU,
VE,
VN,
VG,
VI,
WF,
EH,
YE,
ZM,
ZW,
AX
addresses
object[] | null