---
title: "Preencher um campo do checklist"
method: PUT
path: "/tickets/{ticket_number}/checklists/{id}/items/{index}"
tags: ["Checklists"]
---

# Preencher um campo do checklist

`PUT /tickets/{ticket_number}/checklists/{id}/items/{index}`

Preenche um campo de um checklist do ticket.

- O campo é identificado pela sua **posição** (`index`) dentro do checklist, pois campos não possuem identificador próprio. Consulte a listagem antes de escrever, porque a posição acompanha a ordem dos campos do checklist
- Os atributos aceitos no corpo variam conforme o tipo do campo. Consulte a descrição do parâmetro `item`
- Checklists que não tenham origem em um modelo cadastrado não podem ser atualizados por esta rota, pois não possuem `id`
- Não é possível preencher checklists de um ticket fechado

## Path parameters

- `ticket_number` integer, required
- `id` integer, required
- `index` integer, required

## Request body

- object — Os atributos aceitos dependem do tipo do campo: - `text`, `textarea` e `value`: informe `value` com o conteúdo do campo - `radio`: informe `value` com o identificador da opção escolhida - `checkbox`: informe `options` com as opções que devem ser marcadas ou desmarcadas Enviar `value` para um campo do tipo `checkbox`, ou `options` para os demais tipos, resulta em erro.
  - `value` union — Valor do campo. Para campos do tipo `radio`, o identificador da opção escolhida. Envie nulo para limpar o preenchimento
    - string
    - integer
    - boolean
  - `options` object[] — Opções que serão marcadas ou desmarcadas. Apenas para campos do tipo `checkbox`. As opções não informadas permanecem como estão
    - `id` union, required — Identificador da opção, conforme retornado na listagem de checklists
      - string
      - integer
    - `checked` boolean, required — `true` marca a opção, `false` desmarca

## Response `200`

### **Campo preenchido com sucesso**

- object
  - `id` integer, nullable, required — Identificador do modelo de checklist que originou este checklist (cadastrado em Configurações). É nulo quando o checklist não veio de um modelo ou quando o modelo foi excluído
  - `name` string, nullable, required — Nome do checklist
  - `description` string, nullable — Descrição do checklist
  - `required` boolean, required — Indica se este checklist é obrigatório para o cliente/item de catálogo do ticket. **Atenção:** é um valor informativo e não determina o bloqueio do fechamento. Quem determina é `pending`
  - `pending` boolean, required — Indica se o checklist possui algum campo obrigatório sem preenchimento. Um checklist com `pending: true` **impede o fechamento do ticket**, mesmo que `required` seja `false`
  - `created_at` string, required — Data em que o checklist foi adicionado ao ticket
  - `updated_at` string, required — Data da última alteração do checklist
  - `fields` object[], required — Campos que compõem o checklist, na ordem de exibição. Um campo impede o fechamento do ticket se, e somente se, `required` for `true` e `filled` for `false`
    - `index` integer, required — Posição do campo dentro deste checklist. É a única forma de referenciar um campo, pois campos não possuem identificador próprio. **Atenção:** é posicional, não é um ID persistente
    - `title` string, nullable, required — Nome do campo
    - `type` string, nullable, required — Tipo do campo: `text`, `textarea`, `value`, `radio` ou `checkbox`
    - `required` boolean, required — Indica se o preenchimento deste campo é obrigatório
    - `filled` boolean, required — Indica se o campo está preenchido. A regra varia conforme o tipo: - `text`, `textarea`, `value`: o atributo `value` possui conteúdo - `radio`: o atributo `value` possui o identificador da opção escolhida - `checkbox`: ao menos uma das `options` está marcada
    - `value` union — Valor preenchido no campo. Para campos do tipo `radio`, contém o identificador da opção escolhida. Para campos do tipo `checkbox`, é sempre nulo (o preenchimento fica em `options`)
      - string
      - integer
      - boolean
    - `options` object[], nullable — Opções disponíveis para campos do tipo `radio` e `checkbox`. Nulo para os demais tipos
      - `id` union — Identificador da opção
        - string
        - integer
      - `description` string, nullable — Texto da opção
      - `value` boolean, nullable — Para campos do tipo `checkbox`, `true` indica que a opção está marcada

## Other responses

- `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` — ### **Registro 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)