Update an associated person

Updates the specified associated person by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

Path parameters

employee_idstringRequiredformat: "ee_.+"
associated_person_idstringRequiredformat: "ap_.+"

Request

This endpoint expects an object.
first_namestring or nullOptional

NOTE: This field will be normalized according to our internal formatting rules.

last_namestring or nullOptional

NOTE: This field will be normalized according to our internal formatting rules.

date_of_birthdate or nullOptional

Must be in the past, but after 1900-01-01

sex_at_birthenumOptional
The sex assigned to the associated person at birth
Allowed values:
relationship_typeenumOptional
The relationship type between the employee and the associated person
Allowed values:
emailstring or nullOptional

Email address of the associated person. If null is provided, the email will be cleared. NOTE: This field will be normalized according to our internal formatting rules.

phone_numberstring or nullOptional

Phone number in E.164 international format (e.g. +447700900999). If null is provided, the phone number will be cleared. NOTE: This field will be normalized according to our internal formatting rules.

Response

OK
idstringformat: "ap_.+"
Unique identifier for the associated person
employee_idstringformat: "ee_.+"
Unique identifier for the employee this person is associated with
first_namestring
First name of the associated person
last_namestring
Last name of the associated person
date_of_birthdate
Date of birth of the associated person
sex_at_birthenum
The sex assigned to the associated person at birth
Allowed values:
relationship_typeenum
The relationship type between the employee and the associated person
Allowed values:
platform_idstring or nullformat: "pt_.+"
Unique identifier for the platform
emailstring or null
Email address of the associated person
phone_numberstring or null

Phone number in E.164 international format (e.g. +447700900999)

objectstring or nullRead-only
The object type

Errors