---
title: "Atualizar um Brinde"
method: PUT
path: "/{alias}/pricing/freebies/{id}"
tags: ["Marketing - Brindes"]
---

# Atualizar um Brinde

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

Atualiza informações do Brinde na loja

## Path parameters

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

## Request body

- FreebieRequest — Request para criação/atualização de brindes.
  - `name` string, required — Deve ser único por loja. O valor é sanitizado e normalizado automaticamente.
  - `active` boolean, required — Mostra se a regra está ativa.
  - `start_at` string, date-time, required — Data e hora de início
  - `end_at` string, date-time — Data e hora de término
  - `resource_type` 'sku' | 'product', required — Tipo do item no Brinde, Você pode escolher entre produto ou SKU.
  - `resource_id` integer, required — ID do item ofertado no Brinde.
  - `rule` 'always' | 'products_amount' | 'products_quantity', required — Regra que diz em qual condição o Comprador ganha um brinde. Se será sempre (always), baseado na quantidade de produtos no carrinho (products_quantity) ou no valor total dos prdutos (products_amount).
  - `min_quantity` number — Se escolher a regra para ofertar o brinde pela quantidade de produtos no carrinho, deverá definir a quantidade mínima aqui.
  - `min_amount` number, float — Se escolher a regra para ofertar o brinde pelo valor do carrinho, deverá definir a um valor mínimo aqui.

## Response `200`

Brinde atualizado com sucesso

- Freebie — Atributos do brinde
  - `id` integer — ID do brinde
  - `active` boolean — Indica se o brinde está ativo
  - `store_id` integer — ID da loja associada
  - `name` string — Nome do brinde
  - `start_at` string, date — Data de início da oferta do brinde
  - `expires_at` string, date, nullable — Data de expiração do brinde (se configurado)
  - `resource_id` integer — ID do produto ou SKU vinculado ao brinde
  - `resource_type` string — Pode ser produto ou SKU
  - `rule` string — Regra aplicada ao brinde
  - `min_quantity` integer — Quantidade mínima de produtos no carrinho para receber o brinde
  - `min_amount` number, float — Valor mínimo no carrinho para receber o brinde
  - `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.

## Other responses

- `422` — Dados inválidos. Verifique os campos obrigatórios: name, active, start_at, resource_type, rule e resource_id. Pode ocorrer também quando o valor enviado resulta em uma string vazia após sanitização e normalização.

---

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