---
title: "Update a custom field"
method: PATCH
path: "/v1/fields/{fieldId}"
tags: ["fields"]
---

# Update a custom field

`PATCH /v1/fields/{fieldId}`

Updates the label or fallback text of an existing custom field. Only custom (non-system) fields can be updated. Use the field ID returned by the GET /fields endpoint.

## Path parameters

- `fieldId` string, required

## Request body

- UpdateFieldDto
  - `label` string — The new display name for the custom field. This label will appear in the prospect profile and throughout the application.
  - `fallbackText` string — Updated placeholder text to display when the field has no value for a prospect.

## Response `200`

Custom field updated successfully

- unknown

## Other responses

- `400` — 1001: Field not found<br><br>1001: Default field names cannot be edited<br><br>
- `500` — 5001: Internal server error, please try again later<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) · [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/saleshandy/develop-with-saleshandy/revisions/fdaa0f2dcdfb/schema)