---
title: "Atualizar campo personalizado"
method: PUT
path: "/entities/{id}"
tags: ["Campos personalizados"]
---

# Atualizar campo personalizado

`PUT /entities/{id}`

Atualiza informações sobre um determinado campo personalizado.

## Path parameters

- `id` integer, required

## Request body

- object
  - `name` string — Novo nome do campo personalizado
  - `active` boolean — Ativar ou inativar um campo personalizado
  - `description` string — Nova descrição do campo personalizado
  - `desk_ids` integer[] — Em quais mesas de serviços o campo personalizado será aplicado? Para aplicar um campo personalizado a uma mesa, o campo deve ser do tipo applied_in ticket
  - `equipment_type_id` integer, nullable — Em qual tipo de equipamento o campo personalizado está aplicado. Para aplicar um campo personalizado a um tipo de equipamento, o campo deve ser do tipo applied_in equipment
  - `menu_item` boolean — Informa se o campo personalizado é um item de menu

## Response `200`

### **Campo personalizado atualizado com sucesso**

- object
  - `id` integer, required — Identificador do campo personalizado
  - `active` boolean, required — Informa se o campo personalizado está ativo
  - `applied_in` 'ticket' | 'equipment' | 'client' | 'solicitant' | 'services_catalog' | 'services_catalogs_area' | 'services_catalogs_item', required — Onde o campo personalizado está aplicado
  - `description` string — Descrição do campo personalizado
  - `desk_ids` integer[] — Em quais mesas de serviços o campo personalizado está aplicado. Para aplicar um campo personalizado a uma mesa, o campo deve ser do tipo applied_in ticket
  - `equipment_type_id` integer, nullable — Em qual tipo de equipamento o campo personalizado está aplicado. Para aplicar um campo personalizado a um tipo de equipamento, o campo deve ser do tipo applied_in equipment
  - `menu_item` boolean, required — Informa se o campo personalizado é um item de menu
  - `name` string, required — Nome do campo personalizado
  - `service_catalog` union — Objeto que representa o contexto de aplicação do campo personalizado, contendo os dados do catálogo de serviço ao qual ele está vinculado. A estrutura varia de acordo com o valor do campo `applied_in`. Onde a presença de cada atributo depende do nível de aplicação do campo personalizado
    - object — Se aplicado em um catálogo (`services_catalog`): inclui apenas informações do catálogo
      - `catalog_id` integer — ID do catálogo de serviço
      - `catalog_name` string — Nome do catálogo de serviço
    - object — Se aplicado em uma área (`services_catalogs_area`): inclui informações do catálogo e da sua área
      - `catalog_id` integer — ID do catálogo de serviço
      - `catalog_name` string — Nome do catálogo de serviço
      - `area_id` integer — ID da área de catálogo de serviços
      - `area_name` string — Nome da área de catálogo de serviços
    - object — Se aplicado em um item (`services_catalogs_item`): inclui todos os dados anteriores, além das informações do item de catálogo
      - `catalog_id` integer — ID do catálogo de serviço
      - `catalog_name` string — Nome do catálogo de serviço
      - `area_id` integer — ID da área de catálogo de serviços
      - `area_name` string — Nome da área de catálogo de serviços
      - `item_id` integer — ID do item de catálogo de serviços
      - `item_name` string — Nome do item de catálogo de serviços

## Other responses

- `400` — ### **Problemas com os parâmetros** Essa resposta significa que os parâmetros estão inválidos ou não foi informado um body para a requisição
- `403` — ### **Problemas com permissão** Essa resposta significa que o seu grupo de permissões não possui a permissão necessária para acessar essa rota
- `404` — ### **Campo personalizado não encontrado**
- `422` — ### **Problemas com algum atributo informado**

---

[API](https://skmtc.net/tiflux/apis/tiflux-official-api.md) · [All operations](https://skmtc.net/tiflux/apis/tiflux-official-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiflux/tiflux-official-api/revisions/c656412a58bc/schema)