---
title: "UpdatePersonRequest"
url: "https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8/schemas/UpdatePersonRequest"
---

> Full API specification: https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8.md

# UpdatePersonRequest

Fields to apply to a person. Only non-null fields are applied — omitted or null fields leave the stored value untouched (partial update). `firstName` and `lastName` are required.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Identity API
  version: v1.275.8
servers:
  - url: https://api.sandbox.agentsync.io/id
    description: Sandbox server
  - url: https://api.agentsync.io/id
    description: Production server
components:
  schemas:
    PersonTitle:
      type: string
      nullable: true
      enum:
        - DR
        - MR
        - MRS
        - MS
        - MISS
      description: The person's honorific title.
      example: MS
    PersonSuffix:
      type: string
      nullable: true
      enum:
        - JR
        - SR
        - I
        - II
        - III
        - OBE
        - MBE
        - BSC
        - JP
        - GM
      description: The person's name suffix.
      example: JR
    PersonGender:
      type: string
      nullable: true
      enum:
        - MALE
        - FEMALE
      description: The person's gender.
      example: FEMALE
    UpdatePersonRequest:
      title: UpdatePersonRequest
      description: >
        Fields to apply to a person. Only non-null fields are applied — omitted
        or null fields leave the stored value untouched (partial update).
        `firstName` and `lastName` are required.
      type: object
      required:
        - firstName
        - lastName
      properties:
        firstName:
          type: string
          example: Grace
        lastName:
          type: string
          example: Hopper
        middleName:
          type: string
          nullable: true
        preferredFirstName:
          type: string
          nullable: true
          maxLength: 100
        title:
          $ref: "#/components/schemas/PersonTitle"
        suffix:
          $ref: "#/components/schemas/PersonSuffix"
        dateOfBirth:
          type: string
          format: date
          nullable: true
        gender:
          $ref: "#/components/schemas/PersonGender"
        primaryEmail:
          type: string
          format: email
          nullable: true
        secondaryEmail:
          type: string
          format: email
          nullable: true
        citizenshipCountry:
          type: string
          nullable: true
        residentState:
          type: string
          nullable: true
        unitedStatesCitizen:
          type: boolean
          nullable: true
        unitedStatesWorkAuthorized:
          type: boolean
          nullable: true
        married:
          type: boolean
          nullable: true
        npn:
          type: string
          nullable: true
          maxLength: 12
          pattern: ^[1-9][0-9]*$
          description: National Producer Number. Must start with a non-zero digit and
            contain only digits.
        finraCrdNumber:
          type: string
          nullable: true
          maxLength: 11
          pattern: ^[0-9]+$
          description: FINRA CRD number. Must contain only digits.
        ssn:
          type: string
          nullable: true
          minLength: 9
          maxLength: 9
          pattern: ^[0-9]*$
          description: Social Security Number. Must be exactly 9 digits.
```