# Accepted Attribute Keys

Complete list of accepted `--attr` keys for `face:create` and `face:update`. Keys not on this list are silently ignored.

## Age & Birth

| Key | Example value |
|---|---|
| `age` | `34` |
| `age_range` | `30-39` |
| `birth_date` | `1991-06-15` |
| `birth_year` | `1991` |
| `birth_month` | `June` |
| `birth_decade` | `1990s` |
| `date_of_birth` | `1991-06-15` |

## Current Location

| Key | Example value |
|---|---|
| `address` | `123 Main St, Portland, OR` |
| `location` | `Portland, OR` |
| `residence` | `Portland, Oregon` |
| `region` | `Pacific Northwest` |
| `city` | `Portland` |
| `state` | `Oregon` |
| `country` | `United States` |
| `postal_code` | `97201` |
| `zip_code` | `97201` |

## Birth Location

| Key | Example value |
|---|---|
| `birth_city` | `Seoul` |
| `birth_country` | `South Korea` |
| `birth_location` | `Seoul, South Korea` |
| `birth_place` | `Seoul, South Korea` |
| `place_of_birth` | `Seoul, South Korea` |

## Past Locations

| Key | Example value |
|---|---|
| `location_past` | `Chicago, IL` |
| `residence_past` | `Chicago, Illinois` |
| `previous_address` | `456 Oak Ave, Chicago, IL` |

## Identity & Demographics

| Key | Example value |
|---|---|
| `gender` | `female`, `male`, `non-binary` |
| `ethnicity` | `Korean American` |
| `race` | `Asian` |
| `nationality` | `American` |
| `citizenship` | `United States` |
| `citizenship_status` | `naturalized citizen` |
| `citizenship_past` | `South Korea` |
| `religion` | `Buddhist` |
| `sexual_orientation` | `heterosexual` |

## Immigration

| Key | Example value |
|---|---|
| `immigration` | `immigrated from South Korea` |
| `immigration_age` | `12` |
| `immigration_destination` | `United States` |
| `immigration_status` | `naturalized citizen` |
| `immigration_year` | `2003` |

## Family & Relationships

| Key | Example value |
|---|---|
| `marital_status` | `married`, `single`, `divorced` |
| `marriage_date` | `2018-09-22` |
| `marriage_year` | `2018` |
| `marital_history` | `married once` |
| `spouse` | `David Chen` |
| `spouse_name` | `David Chen` |
| `spouse_occupation` | `software engineer` |
| `number_of_children` | `2` |
| `children_names` | `Lily, Max` |
| `family_size` | `4` |
| `parents` | `Joon-ho Park, Minji Park` |
| `parents_names` | `Joon-ho Park, Minji Park` |
| `parents_occupation` | `teacher, accountant` |
| `mother_name` | `Minji Park` |
| `father_name` | `Joon-ho Park` |

## Work & Career

| Key | Example value |
|---|---|
| `occupation` | `nurse practitioner` |
| `occupation_past` | `registered nurse` |
| `employer` | `Providence Health` |
| `employer_past` | `Oregon Health & Science University` |
| `job_title` | `Senior Nurse Practitioner` |
| `work_location` | `Portland, OR` |
| `industry` | `healthcare` |
| `years_employed` | `8` |
| `employment_status` | `full-time` |
| `income` | `$95,000` |
| `salary` | `$95,000` |

## Education

| Key | Example value |
|---|---|
| `education_level` | `master's degree` |
| `degree` | `MSN` |
| `school` | `Lincoln High School` |
| `school_past` | `Roosevelt Middle School` |
| `university` | `Oregon Health & Science University` |
| `college` | `University of Oregon` |
| `graduation_year` | `2017` |
| `field_of_study` | `nursing` |
| `major` | `nursing` |
| `certifications` | `AANP board certified` |

## Legal & Official

| Key | Example value |
|---|---|
| `legal_name` | `Maria Minji Chen` |
| `birth_name` | `Maria Minji Park` |
| `maiden_name` | `Park` |
| `social_security_number` | *(not recommended)* |
| `tax_id` | *(not recommended)* |
| `driver_license_state` | `Oregon` |
| `passport_country` | `United States` |
| `voter_registration` | `registered` |

## Housing & Property

| Key | Example value |
|---|---|
| `home_ownership` | `owns` |
| `rent_or_own` | `own` |
| `property_value` | `$450,000` |
| `housing_type` | `single-family home` |
| `roommates` | `none` |

## Health & Status

| Key | Example value |
|---|---|
| `disability_status` | `none` |
| `veteran_status` | `non-veteran` |
| `health_insurance` | `employer-provided` |