---
title: "Editar lembrete de consumo do contrato"
method: PUT
path: "/contracts/{contract_id}/consumption-reminders/{id}"
tags: ["Contratos"]
---

# Editar lembrete de consumo do contrato

`PUT /contracts/{contract_id}/consumption-reminders/{id}`

## Request

- Base URL: `https://api.tiflux.com/api/v2`
- URL: `https://api.tiflux.com/api/v2/contracts/{contract_id}/consumption-reminders/{id}`
- Auth: HTTP bearer

Edita as porcentagens, os e-mails ou o `alert_scope` de um lembrete de consumo do contrato. Só os atributos enviados são alterados, e a lista enviada substitui a atual.

As regras são as mesmas da criação, com uma diferença: como na tela, a edição pode deixar o lembrete sem porcentagem ou sem e-mail. Nesse caso ele fica salvo, mas não avisa.

Sem aviso retroativo: as porcentagens novas (ou todas, quando o `alert_scope` passa a incluir um tipo de consumo) que o consumo do ciclo atual já passou só avisam no próximo ciclo.

## Request body

- object: Só os atributos enviados são alterados. A lista enviada substitui a lista atual
  - `percentages` integer[]: (%) Porcentagens de consumo que disparam o aviso: inteiros de 1 a 999, sem repetir, até 10. Acima de 100% avisa o consumo excedente
  - `emails` string[]: E-mails que recebem o aviso
  - `alert_scope` 'contract_only' | 'shifts_only' | 'contract_and_shifts': Consumo avisado: `contract_only` (contrato), `shifts_only` (deslocamentos) ou `contract_and_shifts` (os dois). Deslocamentos só valem para Horas, Limite de atendimento e Horas cumulativas

## Response `200`

Lembrete editado

- object
  - `id` number, required: Identificador do lembrete
  - `percentages` number[], required: (%) Porcentagens de consumo que disparam o aviso
  - `emails` string[], required: E-mails que recebem o aviso
  - `alert_scope` 'contract_only' | 'shifts_only' | 'contract_and_shifts', required: Consumo avisado: `contract_only` (contrato), `shifts_only` (deslocamentos) ou `contract_and_shifts` (os dois). Deslocamentos só valem para Horas, Limite de atendimento e Horas cumulativas

## Other responses

- `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`: Lembrete não encontrado
- `422`: Erro de validação

## Changes

- **2026-11-06** `2936ac99a76d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tiflux/apis/tiflux-official-api/changes/contracts/:contract_id/consumption-reminders/:id/put.md)

---

[API](https://skmtc.dev/tiflux/apis/tiflux-official-api.md) - [All operations](https://skmtc.dev/tiflux/apis/tiflux-official-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tiflux/apis/tiflux-official-api/revisions/2936ac99a76d?raw)