---
title: "Update Global Custom Field"
method: PUT
path: "/persons/custom_field"
tags: ["persons"]
---

# Update Global Custom Field

`PUT /persons/custom_field`

## Query parameters

- `custom_field_urn` union, required — Custom field URN
  - string
  - string
  - string

## Request body

- UpdatePersonListCustomFieldInput
  - `name` string, required
  - `metadata` union
    - SelectListCustomFieldMetadataInputSchema
      - `options` SelectListCustomFieldValueOptionInputSchema[]
        - `urn` string
        - `name` string, required
        - `color` string, required
        - `default` boolean, nullable
    - NumberListCustomFieldMetadata
      - `format` 'NUMBER' | 'PERCENT' | 'US_DOLLAR'
    - DateListCustomFieldMetadata
      - `format` 'MM_DD_YYYY' | 'DD_MM_YYYY' | 'YYYY_MM_DD'
    - PersonListCustomFieldMetadata
      - `mode` 'SINGLE' | 'MULTIPLE', required
    - RecordReferenceListCustomFieldMetadata
      - `record_type_urn` string, required
      - `allow_multiple` boolean, required
      - `mode` string, nullable
  - `default_value` union
    - CheckboxListCustomFieldValue
      - `value` boolean, nullable
    - NumberListCustomFieldValue
      - `value` number, nullable
    - TextListCustomFieldValue
      - `value` string, nullable
    - PersonListCustomFieldDefaultValue
      - `value` string[]
      - `mode` 'FIXED_URN' | 'ADDED_BY_USER', required
    - DateListCustomFieldDefaultValue
      - `value` string, nullable
      - `mode` 'FIXED_DATE' | 'CREATED_AT', required
    - WebsiteListCustomFieldValue
      - `value` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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