---
title: "Update an associated person"
method: PUT
path: "/employees/{employee_id}/associated_persons/{associated_person_id}"
tags: ["Associated Persons"]
---

# Update an associated person

`PUT /employees/{employee_id}/associated_persons/{associated_person_id}`

## Request

- Base URL: `https://test.api.kota.io`
- URL: `https://test.api.kota.io/employees/{employee_id}/associated_persons/{associated_person_id}`
- Auth: HTTP bearer

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

## Path parameters

- `employee_id` string, required
- `associated_person_id` string, required

## Request body

- UpdateAssociatedPersonRequest
  - `first_name` string, nullable: NOTE: This field will be normalized according to our internal formatting rules.
  - `last_name` string, nullable: NOTE: This field will be normalized according to our internal formatting rules.
  - `date_of_birth` string, date, nullable: Must be in the past, but after 1900-01-01
  - `sex_at_birth` 'male' | 'female'
  - `relationship_type` 'spouse' | 'partner' | 'child' | 'other'
  - `email` string, nullable: 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_number` string, nullable: 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 `200`

OK

- AssociatedPersonResponse
  - `id` string, required: Unique identifier for the associated person
  - `platform_id` string: Unique identifier for the platform
  - `employee_id` string, required: Unique identifier for the employee this person is associated with
  - `first_name` string, required: First name of the associated person
  - `last_name` string, required: Last name of the associated person
  - `date_of_birth` string, date, required: Date of birth of the associated person
  - `sex_at_birth` 'male' | 'female', required
  - `relationship_type` 'spouse' | 'partner' | 'child' | 'other', required
  - `email` string, nullable: Email address of the associated person
  - `phone_number` string, nullable: Phone number in E.164 international format (e.g. +447700900999)
  - `object` string: The object type

## Other responses

- `400`: Bad Request
- `404`: Not Found

## Changes

- **2026-10-26** `998f7cb004ab`: 1 warning
  - deleted the `header` request parameter `X-Platform-Id`
- **2026-08-07** `7b8b3ed87c96`: 1 info
  - added the new optional `header` request parameter `X-Platform-Id`

[Operation history](https://skmtc.dev/kota/apis/kota-api/changes/employees/:employee_id/associated_persons/:associated_person_id/put.md)

---

[API](https://skmtc.dev/kota/apis/kota-api.md) - [All operations](https://skmtc.dev/kota/apis/kota-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kota/apis/kota-api/revisions/998f7cb004ab?raw)