---
title: "Atualizar campos personalizados do ticket"
method: PUT
path: "/tickets/{ticket_number}/entities"
tags: ["Tickets"]
---

# Atualizar campos personalizados do ticket

`PUT /tickets/{ticket_number}/entities`

Esta rota permite atualizar os valores de campos personalizados associados a um ticket específico.

- Para consultar quais campos personalizados estão disponíveis para o ticket em questão, utilize o método [Exibir ticket](#get-/tickets/-ticket_number-)

- Se você deseja atualizar o valor de um campo personalizado em um **ticket que esteja fechado**, é necessário ter a permissão <span style="margin:1px; padding:1px 8px; font-weight:bold; border-radius:12px;  background-color: var(--light-red, var(--input-bg)); color:var(--red); border:1px solid var(--red)"><!--?lit$8458964218$-->Editar tickets fechados</span>
### **Descrição dos valores aceitos**
O formato do valor do campo (`value`) deve ser compatível com o tipo de campo personalizado (`entity_field_id`) que está sendo atualizado. Consulte a tabela abaixo para obter exemplos de valores válidos para cada tipo de campo:
Tipo de campo | Descrição | Exemplos
--- | --- | ---
text | Aceita qualquer valor de string | `"Meu texto"`
text_area | Aceita qualquer valor de string | `"Meu texto de exemplo"`
currency | Aceita uma string de números float utilizando o ponto como separador decimal e sem agrupador de milhares | `"1200.55"`,`"15"`
phone | Aceita uma string de números inteiros, representando o número de telefone sem o código do país (DDI). Por padrão, o sistema vai tentar validar esse telefone como um número brasileiro. Se você deseja inserir um número de outro país, será necessário utilizar o atributo `country_code` junto no corpo da sua requisição | `"47999999999"`
email | Aceita uma string com o e-mail | `"suporte@tiflux.com"`
link | Aceita uma string contendo o endereço do link. O link deve começar com http, https ou ftp, para ser considerado como válido | `"https://guia-de-uso.tiflux.com/"`
date | Aceita uma string contendo a data. Serão aceitas datas em vários formatos (inclusive com horas). Porém, o valor será gravado em banco da seguinte forma: "YYYY-MM-DD", sendo assim, recomendamos que você informe a data nesse padrão também | `"2025-05-28"`
single_select | Aceita uma string contendo um número inteiro com o ID da nova opção que foi escolhida | `"777"`, `"52"`
checkbox | Aceita uma string contendo um valor booleano representando se você deseja marcar o checkbox ("true") ou desmarcá-lo ("false") | `"true"`, `"false"`

- **Observação:** Se você deseja apagar/limpar o valor de um campo personalizado que não é obrigatório, basta informar o atributo value como null: `"value": null`

## Path parameters

- `ticket_number` integer, required

## Request body

- Entities
  - `entities` object[]
    - `entity_field_id` integer, required — Identificador único do campo da entidade que será atualizada
    - `entity_field_option_id` integer, nullable — Identificador da opção do campo personalizado a ser atualizado. Este atributo só deve ser informado para campos do tipo `checkbox`
    - `value` string, nullable — Novo valor do campo personalizado. O formato específico de como o valor dessa string deve ser preenchido, depende do tipo de campo personalizado. Consulte a documentação para obter mais detalhes
    - `country_code` string — Código de país no formato <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2" target="_blank">ISO 3166-1 alpha-2</a> Este atributo será utilizado para validar se o número de telefone informado é um número válido no país informado. Esse atributo só será utilizado ao atualizar um campo personalizado do tipo `phone`

## Response `200`

### **Campos personalizados atualizados com sucesso**
O corpo da resposta dessa requisição será um objeto `entities`, contendo todos os campos personalizados do ticket após a atualização

## Other responses

- `207` — ### **Sucesso Parcial na Atualização de Campos Personalizados** Este código de resposta indica que a requisição para atualizar campos personalizados foi **parcialmente bem-sucedida**. Ou seja, alguns dos campos podem ter sido atualizados com sucesso, enquanto outros apresentaram falhas e não foram atualizados. Para os campos que apresentaram falhas na atualização, o motivo do erro está detalhado no atributo `detail`. Se um campo não constar na listagem de erros, significa que ele foi atualizado com sucesso.
- `400` — ### **Parâmetro inválido encontrado** Você informou algum atributo inválido ou fora do padrão dessa requisição. Confira os exemplos e o schema, para garantir que o corpo da sua requisição esteja no formato correto
- `401` — ### **Problemas com o token de autenticação**
- `403` — ### **Problemas com permissão** Essa resposta significa que o seu usuário está autenticado corretamente, porém, não possui a permissão ou licença necessária para acessar essa rota
- `404` — ### **Ticket não encontrado**
- `422` — ### **Problemas com os parâmetros informados**

---

[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)