---
title: "Update field"
method: PATCH
path: "/crm/objects/{objectName}/fields/{fieldName}"
tags: ["crm"]
---

# Update field

`PATCH /crm/objects/{objectName}/fields/{fieldName}`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/crm/objects/{objectName}/fields/{fieldName}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Update a CRM field or change/explicitly clear an existing campaign calculation.

## Path parameters

- `objectName` string, required
- `fieldName` string, required

## Request body

- object
  - `name` string: Rename the field.
  - `description` string
  - `required` boolean
  - `enumValues` string[]: Full replacement of options.
  - `enumColors` string[]
  - `enumMultiple` boolean
  - `indexed` boolean
  - `enrichment` object: Enrichment binding that lets the field auto-fill.
    - `category` 'people' | 'company', required
    - `key` string, required
    - `responsePath` string: Dotted path to the value in the enrichment result. Required.
    - `inputFieldName` string
  - `clearEnrichment` boolean
  - `calculation` object: Replace an existing calculation's metric/source. Stored fields cannot be converted; create a new column instead.
    - `kind` 'campaign_activity', required
    - `metric` 'email_opened' | 'email_clicked' | 'replied' | 'linkedin_connected', required
    - `campaignId` string: Same-workspace multichannel campaign ID readable by the viewer. Omit for any accessible multichannel campaign.
  - `clearCalculation` boolean: Explicitly remove an existing calculation, leaving an editable boolean. Does not snapshot calculated values. Mutually exclusive with calculation.

## Response `200`

Successful response

- object
  - `ok` boolean, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)