---
title: "Update Custom Field"
method: PUT
path: "/settings/custom_fields/{custom_field_uid}"
---

# Update Custom Field

`PUT /settings/custom_fields/{custom_field_uid}`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/settings/custom_fields/{custom_field_uid}`
- Auth: API key in header `x-api-key`

## Path parameters

- `custom_field_uid` string, required

## Request body

- object
  - `module_name` 'JOB' | 'CUSTOMER' | 'EMPLOYEE' | 'ESTIMATE' | 'INVOICE' | 'PRODUCT' | 'PURCHASE_ORDER' | 'MATERIAL_REQUESTS' | 'VENDOR' | 'SERVICE_CONTRACT' | 'ASSET' | 'PROPERTY' | 'ORGANIZATION' | 'TEAM' | 'REQUEST' | 'PROJECT', required
  - `custom_field` object
    - `field_name` string
    - `field_type` 'SINGLE_LINE' | 'MULTI_LINE' | 'SINGLE_ITEM' | 'RADIO' | 'MULTI_ITEM' | 'NUMBER' | 'DATE' | 'TIME' | 'DATETIME' | 'LOOKUP' | 'FILE' | 'MULTI_FILE' | 'VIDEO'
    - `field_description` string
    - `field_placeholder` string
    - `field_options` string[]
    - `lookup_module` 'JOB' | 'CUSTOMER' | 'EMPLOYEE' | 'ESTIMATE' | 'INVOICE' | 'PRODUCT' | 'PURCHASE_ORDER' | 'MATERIAL_REQUESTS' | 'VENDOR' | 'SERVICE_CONTRACT' | 'ASSET' | 'PROPERTY' | 'ORGANIZATION' | 'TEAM': if field_type is "LOOKUP"
    - `field_validation` string: number/regex
    - `regex_value` string: if field_validation is "regex"
    - `min_value` string: if field_validation is "number"
    - `max_value` string: if field_validation is "number"
    - `is_dependent` boolean
    - `dependent_on` string
    - `dependent_options` string[]
    - `default_option` boolean
    - `default_options` string[]
    - `read_only` boolean
    - `hide_to_fe` boolean
    - `hide_field` boolean
    - `is_required` boolean
    - `meta_options` object
      - `restrict_to_camera` boolean
      - `watermark_image` boolean

## Response `200`

200

- object
  - `message` string
  - `title` string
  - `type` string

## Other responses

- `500`: 500

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/settings/custom_fields/:custom_field_uid/put.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)