---
title: "Ordenar ou atualizar banner"
method: PUT
path: "/{alias}/marketing/banners/{id}"
tags: ["Marketing"]
---

# Ordenar ou atualizar banner

`PUT /{alias}/marketing/banners/{id}`

Atualiza a ordem dos banners ou as informações de um banner específico

## Path parameters

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

## Request body

- union
  - BannerSorting — Representa o corpo de uma requisiçao para criar ordenação de banners
    - `sorting` object[], required — Lista de grupos de ordenação
      - `group` 'collections' | 'categories' | 'promotions' | 'home', required — * collections, * categories, * promotions, * home
      - `resource_id` integer, required — ID do recurso a ser ordenado
      - `orders` integer[], required — Ordem dos IDs dos banners
  - BannerRequest — Representa os dados necessários para criar ou atualizar um banner
    - `active` boolean — Indica se o banner está ativo
    - `home` boolean — Indica se o banner aparece na home
    - `name` string — Nome do banner. O valor é sanitizado e normalizado automaticamente.
    - `link` string — Link do banner
    - `image_url` string — URL da imagem do banner
    - `start_at` string, date-time — Data e hora de início
    - `end_at` string, date-time — Data e hora de término
    - `categories_ids` integer[] — IDs das categorias
    - `collections_ids` integer[] — IDs das coleções
    - `promotions_ids` integer[] — IDs das promoções

## Response `200`

Operação realizada com sucesso

- object
  - `id` integer
  - `product_id` integer
  - `active` boolean
  - `type` string
  - `name` string
  - `slug` string
  - `link` string
  - `expired` boolean
  - `image_url` string
  - `mobile_image_url` string
  - `home` boolean
  - `stopwatch` string
  - `stopwatch_expires_in` 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.
  - `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.

## Other responses

- `400` — Dados inválidos fornecidos
- `404` — Banner não encontrado
- `422` — Dados inválidos. Pode ocorrer quando campos obrigatórios estão ausentes, o formato é incorreto, ou 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)