---
title: "Atualizar promoção"
method: PUT
path: "/{alias}/pricing/promotions/{id}"
tags: ["Promoções - Produtos"]
---

# Atualizar promoção

`PUT /{alias}/pricing/promotions/{id}`

Atualiza os detalhes de uma promoção específica

## Path parameters

- `alias` string, required
- `id` integer, required

## Request body

- Promotion
  - `id` integer
  - `active` boolean
  - `all_products` boolean
  - `utm_only` boolean
  - `highlight_on_menu` boolean
  - `accumulate` boolean
  - `price_attribute` string
  - `name` string
  - `expired` boolean
  - `url` string, uri
  - `slug` string
  - `value` number, float
  - `utm_source` string
  - `utm_campaign` string

## Response `200`

Detalhes da promoção

- object — Representa as restrições de inclusão e exclusão para itens específicos
  - `id` integer
  - `active` boolean
  - `all_products` boolean
  - `utm_only` boolean
  - `highlight_on_menu` boolean
  - `accumulate` boolean
  - `price_attribute` string
  - `name` string
  - `expired` boolean
  - `url` string, uri
  - `slug` string
  - `value` number, float
  - `utm_source` string
  - `utm_campaign` string
  - `start_at` BaseTimestamp
    - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
    - `timezone_type` integer — Número de representação do timezone.
    - `timezone` string — Fuso horário associado.
  - `end_at` BaseTimestamp
    - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
    - `timezone_type` integer — Número de representação do timezone.
    - `timezone` string — Fuso horário associado.
  - `created_at` BaseTimestamp
    - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
    - `timezone_type` integer — Número de representação do timezone.
    - `timezone` string — Fuso horário associado.
  - `updated_at` BaseTimestamp
    - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
    - `timezone_type` integer — Número de representação do timezone.
    - `timezone` string — Fuso horário associado.
  - `include` object — Itens a serem incluídos
    - `products_ids` integer[]
    - `brands_ids` integer[]
    - `collections_ids` integer[]
    - `categories_ids` integer[]
  - `exclude` object — Itens a serem excluídos
    - `products_ids` integer[]
    - `brands_ids` integer[]
    - `collections_ids` integer[]
    - `categories_ids` integer[]
  - `include_ids` integer[] — Lista de IDs para inclusão
  - `exclude_ids` integer[] — Lista de IDs para exclusão

## Other responses

- `400` — Dados inválidos fornecidos
- `404` — Promoção não encontrada

---

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