---
title: "Update Discount"
method: PATCH
path: "/app/discount/{discount-id}"
tags: ["Discounts"]
---

# Update Discount

`PATCH /app/discount/{discount-id}`

Atualiza um cupom de desconto.

## Path parameters

- `discount-id` string, required

## Request body

- object
  - `coupon` string — O cupom que será atualizado. Aceita apenas letras, números, hífens e underlines.
  - `applies_to` number[] — Lista de ID dos produtos em que o cupom poderá ser aplicado. Use `[-1]` para aplicar a todos os produtos.
  - `type` 'PRICE' | 'PERCENTAGE' — O tipo do desconto, podendo ser `PRICE` ou `PERCENTAGE`
  - `value` number — O valor do desconto
  - `max_uses` number — A quantidade máxima de usos que o desconto pode ter. Envie `null` para remover o limite.
  - `expires_in` string, date — A data de expiração do desconto. Envie `null` para remover a expiração.
  - `min_price` number — Valor mínimo do pedido para que o cupom possa ser aplicado. Envie `null` para remover. Intervalo: 0 a 999999.
  - `limit_criteria` 'CLIENT_IDENTIFIER' | 'CLIENT_EMAIL' | 'CLIENT_DISCORD' — Critério de limitação de uso por cliente. Quando definido, cada cliente só poderá usar o cupom uma vez com base no critério escolhido. Valores possíveis: `CLIENT_IDENTIFIER`, `CLIENT_EMAIL`, `CLIENT_DISCORD`. Envie `null` para remover.
  - `restricted_to_criteria` 'CLIENT_IDENTIFIER' | 'CLIENT_EMAIL' | 'CLIENT_DISCORD' — Tipo de restrição para limitar o cupom a clientes específicos. Deve ser usado junto com `restricted_to`. Valores possíveis: `CLIENT_IDENTIFIER`, `CLIENT_EMAIL`, `CLIENT_DISCORD`. Envie `null` para remover.
  - `restricted_to` string[] — Lista de identificadores dos clientes que poderão usar o cupom. Requer que `restricted_to_criteria` esteja definido. Envie `null` para remover.

## Response `200`

Cupom de desconto atualizado.

- Discount
  - `id` number
  - `store_id` number
  - `coupon` string
  - `type` 'PRICE' | 'PERCENTAGE'
  - `value` number
  - `applies_to` number[]
  - `uses` number
  - `max_uses` number, nullable
  - `expires_in` string, nullable
  - `min_price` number, nullable
  - `limit_criteria` 'CLIENT_IDENTIFIER' | 'CLIENT_EMAIL' | 'CLIENT_DISCORD', nullable
  - `restricted_to_criteria` 'CLIENT_IDENTIFIER' | 'CLIENT_EMAIL' | 'CLIENT_DISCORD', nullable
  - `restricted_to` string[], nullable
  - `created_at` string
  - `updated_at` string

---

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