---
title: "Update a person"
method: PATCH
path: "/people/{personId}"
tags: ["People"]
---

# Update a person

`PATCH /people/{personId}`

Updates a given person's details.

## Path parameters

- `personId` string, uuid, required — The ID of the person to work with.

## Request body

- object
  - `accountId` string — The ID of the account to work with.
  - `firstName` string
  - `lastName` string
  - `title` 'Master' | 'Mr' | 'Miss' | 'Mrs' | 'Ms' | 'Mx', nullable
  - `middleInitials` string, nullable
  - `dob` string, nullable — Date of birth
  - `gender` string, nullable
  - `nationality` string, nullable
  - `nationalities` string[] — Array of ISO 3166-1 alpha-2 country codes representing person nationalities
  - `countryOfResidence` string, nullable
  - `primaryMobileNumber` string, nullable
  - `emailTheme` 'em-light' | 'em-dark'
  - `preferred2FAMethod` 'sms' | 'whatsapp', nullable
  - `transactionalEmailPreference` boolean, nullable — Indicates whether all the associated personas have opted to receive the emails or not.
  - `locale` 'en-GB' — Determines customer communication language. emails, notifications, etc.

## Response `200`

OK

- object
  - `id` string, uuid, required
  - `firstName` string, required
  - `lastName` string, required
  - `title` 'Master' | 'Mr' | 'Miss' | 'Mrs' | 'Ms' | 'Mx', nullable
  - `middleInitials` string, nullable, required
  - `dob` string, nullable, required
  - `gender` string, nullable, required
  - `nationality` string, nullable, required
  - `nationalities` string[], nullable — Array of ISO 3166-1 alpha-2 country codes representing person nationalities
  - `countryOfResidence` string, nullable, required
  - `primaryMobileNumber` string, nullable
  - `primaryEmailAddress` string, email, required — The primary email address for this person.
  - `avatar` object
    - `url` string
    - `fileName` string
  - `sendInvite` boolean — Send the invite now
  - `roleId` string, uuid
  - `verifyEmailAddress` boolean
  - `verifyMobileNumber` boolean
  - `sub` string, nullable — The Cognito ID of the person to work with.
  - `hasPeopleCard` boolean — Indicates whether this person has an individual card.
  - `card` object, nullable — The individual card object if the person has an individual card
    - `id` string, uuid, required — The id of the card
  - `status` 'active' | 'deactivated' | 'kycReferred' | 'rejected', required
  - `locale` 'en-GB', nullable, required — Determines customer communication language. emails, notifications, etc.
  - `productId` string, uuid, required — The ID of the product to work with.
  - `avatarId` string, uuid, nullable, required
  - `avatarCdnUrl` string, nullable, required
  - `emailTheme` string, nullable
  - `preferred2FAMethod` 'whatsapp' | 'sms', nullable, required
  - `persona` object
  - `createdAt` string, date-time, required — The date the Resource was initially created. ISO 8601 format without milliseconds.
  - `updatedAt` string, date-time, required — The date the Resource was last modified. ISO 8601 format without milliseconds.

---

[API](https://skmtc.net/equalsmoney/apis/cis-api.md) · [All operations](https://skmtc.net/equalsmoney/apis/cis-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/equalsmoney/cis-api/revisions/a162c72b8bf6/schema)