---
title: "Update a single field value on a Person"
method: POST
path: "/v2/persons/{personId}/fields/{fieldId}"
tags: ["Persons"]
---

# Update a single field value on a Person

`POST /v2/persons/{personId}/fields/{fieldId}`

Update a single field value on a person.

## Path parameters

- `personId` integer, required
- `fieldId` string, required

## Request body

- FieldUpdate
  - `value` union
    - CompaniesValueUpdate
      - `type` 'company-multi', required — The type of value
      - `data` CompanyReference[], nullable, required — The values for many companies
        - `id` integer, required — The company's unique identifier
    - CompanyValueUpdate
      - `type` 'company', required — The type of value
      - `data` CompanyReference, required
        - `id` integer, required — The company's unique identifier
    - DateValue
      - `type` 'datetime', required — The type of value
      - `data` string, date-time, nullable, required — The value for a date
    - DropdownValueUpdate
      - `type` 'dropdown', required — The type of value
      - `data` DropdownReference, required
        - `dropdownOptionId` integer, required — Dropdown item's unique identifier
    - DropdownsValueUpdate
      - `type` 'dropdown-multi', required — The type of value
      - `data` DropdownReference[], nullable, required — The value for many dropdown items
        - `dropdownOptionId` integer, required — Dropdown item's unique identifier
    - FloatValue
      - `type` 'number', required — The type of value
      - `data` number, nullable, required — The value for a number
    - FloatsValue
      - `type` 'number-multi', required — The type of value
      - `data` number[], nullable, required — The value for many numbers
      - `totalCount` integer — The total number of values for this field. When totalCount exceeds the length of data, additional values can be retrieved using the field values endpoint.
    - LocationValue
      - `type` 'location', required — The type of value
      - `data` Location, required
        - `streetAddress` string, nullable, required — Street address
        - `city` string, nullable, required — City
        - `state` string, nullable, required — State
        - `country` string, nullable, required — Country
        - `continent` string, nullable, required — Continent
    - LocationsValue
      - `type` 'location-multi', required — The type of value
      - `data` Location[], nullable, required — The values for many locations
        - `streetAddress` string, nullable, required — Street address
        - `city` string, nullable, required — City
        - `state` string, nullable, required — State
        - `country` string, nullable, required — Country
        - `continent` string, nullable, required — Continent
      - `totalCount` integer — The total number of values for this field. When totalCount exceeds the length of data, additional values can be retrieved using the field values endpoint.
    - PersonValueUpdate
      - `type` 'person', required — The type of value
      - `data` PersonReference, required
        - `id` integer, required — The persons's unique identifier
    - PersonsValueUpdate
      - `type` 'person-multi', required — The type of value
      - `data` PersonReference[], nullable, required — The values for many persons
        - `id` integer, required — The persons's unique identifier
    - RankedDropdownValueUpdate
      - `type` 'ranked-dropdown', required — The type of value
      - `data` RankedDropdownReference, required
        - `dropdownOptionId` integer, required — Ranked Dropdown item's unique identifier
    - TextValue
      - `type` 'filterable-text' | 'text', required — The type of value
      - `data` string, nullable, required — The value for a string
    - TextsValue
      - `type` 'filterable-text-multi', required — The type of value
      - `data` string[], nullable, required — The value for many strings
      - `totalCount` integer — The total number of values for this field. When totalCount exceeds the length of data, additional values can be retrieved using the field values endpoint.

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `default` — Errors

---

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