---
title: "Excluir promoções"
method: POST
path: "/api/promotions/batch-delete"
tags: ["Admin API · Promoções"]
---

# Excluir promoções

`POST /api/promotions/batch-delete`

## Request

- Base URL: `https://sualoja.commerce-wake.tech`
- URL: `https://sualoja.commerce-wake.tech/api/promotions/batch-delete`
- Auth: HTTP bearer

Exclui de 1 a 100 promoções por requisição. Promoções excluídas deixam de ser aplicadas e de aparecer nas
consultas. IDs repetidos são processados uma vez. O resultado é individual: verifique `deleted` de cada item.
            
Permissão: **Cadastro de promoções — visualização e edição**.

## Headers

- `x-api-version` '2.0', required

## Request body

- DeletePromotionsCommand: Promoções a excluir. `deletePromotionsCommandHandler`
  - `promotionIds` integer[], required: Obrigatório. De 1 a 100 IDs de promoções, todos maiores que zero. IDs repetidos são processados uma vez.

## Response `200`

Um resultado por promoção em `data.results`, mesmo quando nenhuma é excluída.

- AsgardResponseDTODeletePromotionsResponseDTO
  - `data` DeletePromotionsResponseDTO: Resultado da exclusão em lote.
    - `results` DeletePromotionResultItemDTO[], nullable: Um resultado por promoção informada.
      - `promotionId` integer: ID da promoção processada.
      - `success` boolean: Legado: mesmo valor de `deleted`.
      - `deleted` boolean: `true` quando a promoção foi excluída. Verifique cada item.
      - `message` string, nullable: Mensagem do resultado (ex.: "Promoção não encontrada.").

## Other responses

- `400`: Lista vazia, com mais de 100 IDs ou com ID menor ou igual a zero (`VALIDATION_FAILED`).
- `401`: Token ausente, inválido ou expirado (SESSION_INVALID), ou sem a permissão exigida (UNAUTHORIZED).
- `404`: Falha da requisição inteira, sem resultado por item.
- `409`: Falha da requisição inteira, sem resultado por item.
- `500`: Erro inesperado. Tente de novo; se persistir, contate o suporte com o traceId.

---

[API](https://skmtc.dev/fbits/apis/admin-api.md) - [All operations](https://skmtc.dev/fbits/apis/admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fbits/apis/admin-api/revisions/a37bfd1b0bf3?raw)