---
title: "Update custom fields of a catalog"
method: PATCH
path: "/api/v4/catalogs/{id}/custom_fields"
---

# Update custom fields of a catalog

`PATCH /api/v4/catalogs/{id}/custom_fields`

This method allows updating multiple custom fields of a list

## Path parameters

- `id` integer, required

## Request body

- object
  - `RAW_BODY` object[]
    - `id` integer — Custom field ID
    - `name` string — Field name
    - `sort` integer — Field sorting in the field group
    - `settings` string, json
    - `is_visible` boolean — Defines whether the field is displayed in the list interface
    - `is_required` boolean — Defines whether the field is mandatory when creating a list element
    - `remind` string — Available only for the birthday type fields. Birthday reminders setting (never, day – day before the event, week – week before the event, month – month before the event)
    - `enums` object[] — Available for the following field types: `multiselect`, `radiobutton`, `select`
      - `id` string — You must pass the ID if you want to update the field without deleting the existing enums. If you do not pass this field, the existing enums will be deleted
      - `value` string — Value
      - `sort` integer — Value sorting
      - `code` string — Value symbolic code
    - `nested` object[] — Available for the following field types: category
      - `id` integer — Nested value ID. Shouldn’t be passed when creating a new value
      - `parent_id` integer — Nested value parent ID
      - `value` string — The value of the nested value
      - `sort` integer — Nested value sorting
      - `request_id` string — Temporary identifier of a nested value. Identifier should be unique for the request, isn’t saved anywhere, and is used to create more than one nesting level within one request
      - `parent_request_id` string — Temporary identifier of a nested value parent. Identifier is used only at the time of the request, isn’t saved anywhere, and defines the nesting level of the added element if the parent element hasn’t been created yet

## Response `201`

201

- object
  - `_total_items` integer
  - `_embedded` object
    - `custom_fields` object[]
      - `id` integer
      - `name` string
      - `type` string
      - `account_id` integer
      - `code` string
      - `sort` integer
      - `is_api_only` boolean
      - `enums` unknown
      - `request_id` string
      - `catalog_id` integer
      - `is_visible` boolean
      - `is_deletable` boolean
      - `is_required` boolean
      - `nested` unknown
      - `entity_type` string
      - `_links` object
        - `self` object
          - `href` string

## Other responses

- `400` — 400
- `401` — 401
- `422` — 422

---

[API](https://skmtc.dev/kommo/apis/kommo-api-references.md) · [All operations](https://skmtc.dev/kommo/apis/kommo-api-references/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kommo/kommo-api-references/revisions/f17af4d23c7c/schema)