---
title: "Update Person by Contact Id"
method: PATCH
path: "/contacts/{contactId}/persons/{personId}"
tags: ["Contacts"]
---

# Update Person by Contact Id

`PATCH /contacts/{contactId}/persons/{personId}`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/contacts/{contactId}/persons/{personId}`
- Auth: `appAuth` (a scheme the document does not define)

See glossary for definition of <a href="https://developers.zoopla.co.uk/docs/glossary#person">Person</a>.

## Path parameters

- `contactId` string, required
- `personId` string, required

## Headers

- `AgencyRef` string, required

## Request body

- SystemTextJsonPatchOperationsOperation1AltoContactsApiModelsRequestsPatchPersonRequest[]: Array of operations to perform
  - union
    - object: The formal title of the Person.
      - `op` 'replace'
      - `value` string
      - `path` string
    - object: The first or given name of the Person.
      - `op` 'replace'
      - `value` string
      - `path` string
    - object: The surname of the Person.
      - `op` 'replace'
      - `value` string
      - `path` string
    - object: A list of the Person's phone numbers.
      - `op` 'replace'
      - `value` string
      - `path` string
    - object: A list of the Person's email addresses.
      - `op` 'replace'
      - `value` string
      - `path` string

## Response `200`

Returns the updated Person.

- AltoContactsApiModelsResponsesPatchPersonResponse
  - `id` string, nullable: The unique identifier for the resource.
  - `links` AltoApiMaterialHateoasLink[], nullable: Links to related entities.
    - `href` string, nullable
    - `rel` string, nullable
  - `title` string, nullable: The formal title of the Person.
  - `forename` string, nullable: The first or given name of the Person.
  - `surname` string, nullable: The surname of the Person.
  - `phoneNumbers` AltoContactsApiModelsResponsesPhone[], nullable: A list of the Person's phone numbers.
    - `preferenceOrder` integer: The numerical order in which phone numbers are to be selected.
    - `type` 'Unspecified' | 'Home' | 'Business' | 'Mobile' | 'Fax' | 'Work' | 'ISDN': The type of phone number.
    - `number` string, nullable: The telephone number for the Contact.
    - `description` string, nullable: The description of the phone number
  - `emailAddresses` AltoContactsApiModelsResponsesEmailAddress[], nullable: A list of the Person's email addresses
    - `preferenceOrder` integer: The numerical order in which email addresses are to be selected.
    - `type` 'Unknown' | 'Personal' | 'Business': The type of email address.
    - `address` string, nullable: The email address.

## Other responses

- `400`: Invalid Patch request.
- `404`: Contact or Person not found.
- `500`: The Person could not be written. The response body identifies the failure.

---

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