---
title: "Changes to Updates a custom field"
method: PATCH
path: "/api/v2/custom_fields/{id}"
---

# Changes to Updates a custom field

`PATCH /api/v2/custom_fields/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 49 revisions.

- **2026-11-03** `7dcc2525e812`: 1 warning
- **2026-11-02** `fa3060fd0144`: 3 warning, 10 info
- **2026-10-27** `f11a8740641a`: 4 breaking, 1 warning, 35 info
- **2026-10-02** `5f834ea481fc`: 2 breaking
- **2026-08-27** `bbf5057edf0d`: 1 warning, 3 info

## Changes

- **2026-11-03** `7dcc2525e812`: 1 warning
  - added the new `project_already_exported` enum value to the `errors/items/code` response property for the response status `409`
- **2026-11-02** `fa3060fd0144`: 3 warning, 10 info
  - added the new `bad_decimal_format` enum value to the `errors/items/code` response property for the response status `422`
  - added the new `non_finite_number` enum value to the `errors/items/code` response property for the response status `422`
  - added the new `null_bytes_in_params` enum value to the `errors/items/code` response property for the response status `422`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `406`
  - added the non-success response with the status `408`
  - added the non-success response with the status `415`
  - added the non-success response with the status `423`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
- **2026-10-27** `f11a8740641a`: 4 breaking, 1 warning, 35 info
  - the `data/attributes/aggregation_type_id` response's property type changed from `integer` to no type for status `200`
  - the `data/attributes/archived_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200`
  - the `data/attributes/formatting_type_id` response's property type changed from `integer` to no type for status `200`
  - the `data/attributes/global` response's property type changed from `boolean` to no type for status `200`
  - deleted the `header` request parameter `X-Organization-Id`
  - added the non-success response with the status `409`
  - added the non-success response with the status `422`
  - added the optional property `data/attributes/tag_field` to the response with the `200` status
  - added `#/components/schemas/_collection_linkage` to the `data/relationships/custom_field_people` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/_collection_linkage` to the `data/relationships/options` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/organization` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/project` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/section` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/survey` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/aggregation_type_id, subschema #2` to the `data/attributes/aggregation_type_id` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/archived_at, subschema #2` to the `data/attributes/archived_at` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/formatting_type_id, subschema #2` to the `data/attributes/formatting_type_id` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/global, subschema #2` to the `data/attributes/global` response property `anyOf` list for the response status `200`
  - removed `subschema #1: Collection data` from the `data/relationships/custom_field_people` response property `anyOf` list for the response status `200`
  - removed `subschema #1: Collection data` from the `data/relationships/options` response property `anyOf` list for the response status `200`
  - removed `subschema #1: Single data` from the `data/relationships/organization` response property `anyOf` list for the response status `200`
  - removed `subschema #1: Single data` from the `data/relationships/project` response property `anyOf` list for the response status `200`
  - removed `subschema #1: Single data` from the `data/relationships/section` response property `anyOf` list for the response status `200`
  - removed `subschema #1: Single data` from the `data/relationships/survey` response property `anyOf` list for the response status `200`
  - the response property `data/relationships/custom_field_people/anyOf[subschema #2: Not included]/meta` became required for the status `200`
  - the response property `data/relationships/custom_field_people/anyOf[subschema #2: Not included]/meta/included` became required for the status `200`
  - the response property `data/relationships/options/anyOf[subschema #2: Not included]/meta` became required for the status `200`
  - the response property `data/relationships/options/anyOf[subschema #2: Not included]/meta/included` became required for the status `200`
  - the response property `data/relationships/organization/anyOf[subschema #2: Not included]/meta` became required for the status `200`
  - the response property `data/relationships/organization/anyOf[subschema #2: Not included]/meta/included` became required for the status `200`
  - the response property `data/relationships/project/anyOf[subschema #2: Not included]/meta` became required for the status `200`
  - the response property `data/relationships/project/anyOf[subschema #2: Not included]/meta/included` became required for the status `200`
  - the response property `data/relationships/section/anyOf[subschema #2: Not included]/meta` became required for the status `200`
  - the response property `data/relationships/section/anyOf[subschema #2: Not included]/meta/included` became required for the status `200`
  - the response property `data/relationships/survey/anyOf[subschema #2: Not included]/meta` became required for the status `200`
  - the response property `data/relationships/survey/anyOf[subschema #2: Not included]/meta/included` became required for the status `200`
  - removed the `1.00` enum value from the `data/attributes/aggregation_type_id` response property for the response status `200`
  - removed the `1.00` enum value from the `data/attributes/formatting_type_id` response property for the response status `200`
  - removed the `2.00` enum value from the `data/attributes/aggregation_type_id` response property for the response status `200`
  - removed the `2.00` enum value from the `data/attributes/formatting_type_id` response property for the response status `200`
  - …this revision’s changelog is incomplete
- **2026-10-02** `5f834ea481fc`: 2 breaking
  - the `data/attributes/maximum_value` request property type changed from no type to `number`
  - the `data/attributes/minimum_value` request property type changed from no type to `number`
- **2026-08-27** `bbf5057edf0d`: 1 warning, 3 info
  - added the new `8.00` enum value to the `data/attributes/data_type_id` response property for the response status `200`
  - added the new optional request property `data/attributes/maximum_value`
  - added the new optional request property `data/attributes/minimum_value`
  - added the new `8.00` enum value to the request property `data/attributes/data_type_id`

---

[Operation](https://skmtc.dev/productive/apis/api-documentation/docs/api/v2/custom_fields/:id/patch.md) - [API](https://skmtc.dev/productive/apis/api-documentation.md) - [Page](https://skmtc.dev/productive/apis/api-documentation/changes/api/v2/custom_fields/:id/patch)
