Associated Persons
Update Associated Person
Partially update an associated person and recompute onboarding requirements
PATCH
Partially updates an associated person and recomputes onboarding requirements. All fields are optional; omitted fields are left untouched. Contact/display corrections may apply immediately; identity, role, ownership, signatory, and address changes can require additional verification review and may reset the person’s hosted verification.
Path Parameters
string
required
Id of the Platform customer.
string
required
Id of the parent account.
string
required
Id of the associated person.
Request Body
enum
One of
ultimate_beneficial_owner, director, control_person.boolean
Whether this person is an authorized signer for the entity (eligible to sign agreements). Changing this field to
true does not trigger additional email, phone, or OTP validation.string
Given name. Max 100 characters.
string
Middle name. Max 100 characters.
string
Family name. Max 100 characters.
email
Contact email address.
string
Contact phone number.
date
Date of birth, ISO 8601.
string
Country of residence, ISO 3166-1 alpha-2 (2 letters).
string
Nationality, ISO 3166-1 alpha-2 (2 letters).
decimal
Ownership stake with at most 5 digits and 2 decimal places. The API does not enforce a 0–100 range. This PATCH field is optional, including when changing
role.Address
Residential address. Send its
country as ISO 3166-1 alpha-2; the shared Address schema does not enforce its length.array
Replacement identity-document metadata: a list of
{ type, number, issuing_country } objects (same shape as in create). type is a free string with a 100-character maximum.Response
Returns200 with the updated associated-person object.