---
title: "Actualizar campos personalizados de una lista"
method: PATCH
path: "/api/v4/catalogs/{id}/custom_fields"
---

# Actualizar campos personalizados de una lista

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

Este método permite actualizar múltiples campos personalizados de una lista.

## Path parameters

- `id` integer, required

## Request body

- object
  - `RAW_BODY` object[]
    - `id` integer — ID del campo
    - `name` string — Nombre del campo
    - `code` string — Código del campo que se puede utilizar para actualizar el valor del campo sin pasar el ID del campo en la solicitud.
    - `sort` integer — Ordenación de los campos en el grupo de campos
    - `settings` string, json — Configuración de campos
    - `is_visible` boolean — Define si el campo se muestra en la interfaz de la lista
    - `is_required` boolean — Define si el campo es obligatorio al crear un elemento de la lista
    - `remind` string — Configuración de recordatorios de cumpleaños (nunca, día – día antes del evento, semana – semana antes del evento, mes – mes antes del evento)
    - `enums` object[] — Disponible y obligatorio para los siguientes tipos de campo: multiselección/botón de radio/desplegable
      - `value` string — Valor
      - `sort` integer — Ordenación de los valores
      - `code` string — Código simbólico del valor
    - `nested` object[] — Disponible para los siguientes tipos de campo: categoría
      - `id` integer — ID de valor anidado. No debe ser pasado al crear un nuevo valor
      - `parent_id` integer — ID del valor padre anidado
      - `value` string — El valor del valor anidado
      - `sort` integer — Ordenación del valor anidado
      - `request_id` string — Identificador temporal de un valor anidado. El identificador debe ser único para la solicitud, no se guarda en ningún lugar y se utiliza para crear más de un nivel de anidamiento dentro de una misma solicitud
      - `parent_request_id` string — Identificador temporal de un valor padre anidado. El identificador se utiliza solo en el momento de la solicitud, no se guarda en ningún lugar y define el nivel de anidamiento del elemento añadido si el elemento padre aún no ha sido creado

## Response `200`

200

- 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.md) · [All operations](https://skmtc.dev/kommo/apis/kommo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kommo/kommo-api/revisions/e291c0b2038d/schema)