---
title: "Update sandbox individual"
method: PUT
path: "/sandbox/individual/{individual_id}"
tags: ["Sandbox"]
---

# Update sandbox individual

`PUT /sandbox/individual/{individual_id}`

## Request body

- IndividualWithoutId
  - `first_name` string, nullable — The legal first name of the individual.
  - `middle_name` string, nullable — The legal middle name of the individual.
  - `last_name` string, nullable — The legal last name of the individual.
  - `preferred_name` string, nullable — The preferred name of the individual.
  - `emails` object[], nullable
    - `data` string
    - `type` 'work' | 'personal' | 'null', nullable
  - `phone_numbers` object[], nullable
    - `data` string, nullable
    - `type` 'work' | 'personal' | 'null', nullable
  - `gender` 'female' | 'male' | 'other' | 'decline_to_specify' | 'null', nullable — The gender of the individual.
  - `ethnicity` 'asian' | 'white' | 'black_or_african_american' | 'native_hawaiian_or_pacific_islander' | 'american_indian_or_alaska_native' | 'hispanic_or_latino' | 'two_or_more_races' | 'decline_to_specify' | 'null', nullable — The EEOC-defined ethnicity of the individual.
  - `marital_status` 'single' | 'married' | 'divorced' | 'widowed' | 'domestic_partner' | 'unknown' | 'null', nullable — The employee's marital status, used for beneficiary designation and spousal consent workflows.
  - `dob` string, nullable
  - `ssn` string, nullable — Social Security Number of the individual. This field is only available with the `ssn` scope enabled and the `options: { include: ['ssn'] }` param set in the body. [Click here to learn more about enabling the SSN field](/developer-resources/Enable-SSN-Field).
  - `encrypted_ssn` string, nullable — Social Security Number of the individual in **encrypted** format. This field is only available with the `ssn` scope enabled and the `options: { include: ['ssn'] }` param set in the body.
  - `residence` Location, nullable
    - `line1` string, nullable, required — Street address or PO box.
    - `line2` string, nullable, required — Apartment, suite, unit, or building.
    - `city` string, nullable, required — City, district, suburb, town, or village.
    - `state` string, nullable, required — The state code.
    - `postal_code` string, nullable, required — The postal code or zip code.
    - `country` string, nullable, required — The 2-letter ISO 3166 country code.
    - `name` string, nullable
    - `source_id` string, nullable

## Response `200`

OK

- Individual
  - `first_name` string, nullable — The legal first name of the individual.
  - `middle_name` string, nullable — The legal middle name of the individual.
  - `last_name` string, nullable — The legal last name of the individual.
  - `preferred_name` string, nullable — The preferred name of the individual.
  - `emails` object[], nullable
    - `data` string
    - `type` 'work' | 'personal' | 'null', nullable
  - `phone_numbers` object[], nullable
    - `data` string, nullable
    - `type` 'work' | 'personal' | 'null', nullable
  - `gender` 'female' | 'male' | 'other' | 'decline_to_specify' | 'null', nullable — The gender of the individual.
  - `ethnicity` 'asian' | 'white' | 'black_or_african_american' | 'native_hawaiian_or_pacific_islander' | 'american_indian_or_alaska_native' | 'hispanic_or_latino' | 'two_or_more_races' | 'decline_to_specify' | 'null', nullable — The EEOC-defined ethnicity of the individual.
  - `marital_status` 'single' | 'married' | 'divorced' | 'widowed' | 'domestic_partner' | 'unknown' | 'null', nullable — The employee's marital status, used for beneficiary designation and spousal consent workflows.
  - `dob` string, nullable
  - `ssn` string, nullable — Social Security Number of the individual. This field is only available with the `ssn` scope enabled and the `options: { include: ['ssn'] }` param set in the body. [Click here to learn more about enabling the SSN field](/developer-resources/Enable-SSN-Field).
  - `encrypted_ssn` string, nullable — Social Security Number of the individual in **encrypted** format. This field is only available with the `ssn` scope enabled and the `options: { include: ['ssn'] }` param set in the body.
  - `residence` Location, nullable
    - `line1` string, nullable, required — Street address or PO box.
    - `line2` string, nullable, required — Apartment, suite, unit, or building.
    - `city` string, nullable, required — City, district, suburb, town, or village.
    - `state` string, nullable, required — The state code.
    - `postal_code` string, nullable, required — The postal code or zip code.
    - `country` string, nullable, required — The 2-letter ISO 3166 country code.
    - `name` string, nullable
    - `source_id` string, nullable
  - `id` string, uuid — A stable Finch `id` (UUID v4) for an individual in the company.

---

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