---
title: "Update custom field"
method: POST
path: "/custom_fields/{id}"
tags: ["Custom Fields"]
---

# Update custom field

`POST /custom_fields/{id}`

Update the name of a custom field or the name of its values.

## Path parameters

- `id` string, required

## Request body

- CustomFieldUpdate
  - `name` string, required — The name of the custom field, which is an understandable description of the data it holds.
  - `values` CustomFieldValuesUpdate[] — List of values the custom field can take. Only applicable to custom fields with `select` type.
    - `key` string, required — The key of the value, whether you update them or not.
    - `name` string, required — The name of the value, whether you update them or not.

## Response `200`

200

- CustomFieldDetails
  - `key` string, required — The key of the custom field.
  - `name` string, required — The name of the custom field.
  - `type` 'select' | 'text', required — The type of the custom field.
  - `object_types` string[], required — The types of object this custom field can be applied to.
  - `values` CustomFieldValuesCreation[], required — List of values the custom field can take. Only applicable to custom fields with `select` type.
    - `key` string, required — The key of the value. Must be unique in the custom field and `snake_case`.
    - `name` string, required — The name of the value.
  - `created_at` string, date-time, required — The UTC timestamp of the creation of the custom field.

## Other responses

- `400` — Validation error.
- `404` — The specified resource was not found.
- `409` — Conflict.
- `415` — Unsupported Media Type.

---

[API](https://skmtc.net/numeral/apis/payments.md) · [All operations](https://skmtc.net/numeral/apis/payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/numeral/payments/revisions/220f101cc2ef/schema)