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

# Atualizando campos personalizados de uma lista

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

## Request

- Base URL: `https://subdomain.kommo.com`
- URL: `https://subdomain.kommo.com/api/v4/catalogs/{id}/custom_fields`
- Auth: OAuth 2

Este método permite atualizar múltiplos campos personalizados de uma lista.

## Path parameters

- `id` string, required

## Request body

- object
  - `RAW_BODY` object[]
    - `id` integer: ID do campo
    - `name` string: Nome do campo
    - `code` string: Código do campo que pode ser usado para atualizar o valor do campo sem passar o ID do campo na solicitação
    - `sort` integer: Ordenação do campo no grupo de campos
    - `settings` string, json: Configurações do campo
    - `is_visible` boolean: Define se o campo é exibido na interface da lista
    - `is_required` boolean: Define se o campo é obrigatório ao criar um elemento da lista
    - `remind` string: Configuração de lembretes de aniversário (nunca, dia – um dia antes do evento, semana – uma semana antes do evento, mês – um mês antes do evento)
    - `enums` object[]: Disponível e obrigatório para os seguintes tipos de campo: multiselect/radiobutton/select
      - `value` string: Valor
      - `sort` integer: Ordenação dos valores
      - `code` string: Código simbólico do valor
    - `nested` object[]: Disponível para os seguintes tipos de campo: categoria
      - `id` integer: ID do valor aninhado. Não deve ser passado ao criar um novo valor
      - `parent_id` integer: ID do pai do valor aninhado
      - `value` string: Valor do valor aninhado
      - `sort` integer: Ordenação do valor aninhado
      - `request_id` string: Identificador temporário de um valor aninhado. O identificador deve ser único para a solicitação, não é salvo em nenhum lugar e é usado para criar mais de um nível de aninhamento dentro de uma solicitação.
      - `parent_request_id` string: Identificador temporário do pai de um valor aninhado. O identificador é usado apenas no momento da solicitação, não é salvo em nenhum lugar e define o nível de aninhamento do elemento adicionado caso o elemento pai ainda não tenha sido criado.

## 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/referencias-de-api-da-kommo.md) - [All operations](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/llms.txt) - [OpenAPI document](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/revisions/55101699dddb?raw)