---
title: "Update a persona"
method: PATCH
path: "/personas/{personaId}"
tags: ["People"]
---

# Update a persona

`PATCH /personas/{personaId}`

Updates the details of the specified persona.

## Path parameters

- `personaId` string, uuid, required — The ID of the persona to work with.

## Query parameters

- `accountId` string, required — The ID of the account to work with.

## Request body

- object
  - `emailAddress` string, nullable
  - `employeeNumber` string, nullable
  - `workNumber` string, nullable
  - `jobTitle` string, nullable
  - `status` 'active' | 'deactivated'
  - `transactionalEmailPreference` boolean, nullable — Indicates whether this persona has opted to receive the emails or not.
  - `marketingEmailsPreference` boolean, nullable — Indicates whether this persona has opted to receive the marketing emails or not.
  - `securityNotificationsPreference` boolean, nullable — Indicates whether this persona has opted to receive the security notifications or not.
  - `cardTransactionPushNotificationPreference` boolean — User preference for receiving push notifications for each individual card transaction.

## Response `200`

OK

- object
  - `id` string, uuid, required
  - `accountId` string, required — The ID of the account to work with.
  - `emailAddress` string, nullable, required
  - `employeeNumber` string, nullable, required
  - `workNumber` string, nullable, required
  - `jobTitle` string, nullable, required
  - `status` 'active' | 'deactivated' | 'created' | 'invited' | 'inviteExpired', nullable, required
  - `addresses` object[]
    - `id` string, uuid, required — The ID of the address.
    - `type` string, required — The address type.
    - `nickName` string, nullable — The nickname of the address.
    - `addressLine1` string, required — The first line of the address.
    - `addressLine2` string, nullable — The second line of the address.
    - `addressLine3` string, nullable — The third line of the address.
    - `addressContact` string, nullable — The name of the contact associated with the address.
    - `city` string, required — The city of the address.
    - `postcode` string, required — The postal or ZIP code of the address.
    - `country` string, required — The country of the address.
    - `countryCode` string, nullable — ISO 3166-1 2 digit country code.
    - `createdAt` string, date-time — The date the Resource was initially created. ISO 8601 format without milliseconds.
    - `updatedAt` string, date-time — The date the Resource was last modified. ISO 8601 format without milliseconds.
  - `createdBy` object, nullable
  - `createdByPersonaId` string, uuid, nullable, required — The ID of the persona to work with.
  - `primaryOwnerOf` object, nullable
  - `teams` object[]
    - `id` string, uuid, required
    - `accountId` string — The ID of the account to work with.
    - `name` string, nullable, required
    - `description` string, nullable, required
    - `enabled` boolean, required
    - `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.
  - `transactionalEmailPreference` boolean, nullable — Indicates whether this persona has opted to receive the emails or not.
  - `cardTransactionPushNotificationPreference` boolean — User preference for receiving push notifications for each individual card transaction.
  - `inviteSentDate` string, date-time, nullable — The date the signup was created or updated. ISO 8601 format. Invites are valid for 14 days.
  - `marketingEmails` boolean, required
  - `securityNotifications` boolean, required
  - `createdAt` string, date-time — The date the Resource was initially created. ISO 8601 format without milliseconds.
  - `updatedAt` string, date-time — 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)