API ReferenceAssociated Persons

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.

Authentication

AuthorizationBearer
Authorization header using the Bearer scheme

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_birthenum or nullOptional
The sex assigned to the associated person at birth
Allowed values:
relationship_typeenum or nullOptional
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:
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 null
The object type

Errors