---
title: "Ativar ou inativar promoção"
method: PUT
path: "/api/promotions/{promotionId}/status"
tags: ["Admin API · Promoções"]
---

# Ativar ou inativar promoção

`PUT /api/promotions/{promotionId}/status`

## Request

- Base URL: `https://sualoja.commerce-wake.tech`
- URL: `https://sualoja.commerce-wake.tech/api/promotions/{promotionId}/status`
- Auth: HTTP bearer

Liga ou desliga a promoção sem alterar o restante do cadastro.
            
Sem datas, a promoção é ativada com a vigência atual. Se essa vigência já terminou, a resposta é `400`:
envie `startDate` e `endDate`, que então substituem a vigência. Enviar só uma das datas é recusado.
Ao inativar, omita as datas.
            
Permissão: **Ativação de promoções — visualização e edição**.

## Path parameters

- `promotionId` integer, required

## Headers

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

## Request body

- PutPromotionStatusCommand
  - `active` boolean, required: Obrigatório. `true` ativa, `false` inativa.
  - `startDate` string, date-time, nullable: Nova data de início. Use só ao ativar, junto com `endDate`.
  - `endDate` string, date-time, nullable: Nova data de término, maior que o início e que o momento atual. Use só ao ativar, junto com `startDate`.

## Response `200`

Status alterado.

- AsgardResponseDTOPutPromotionStatusCommandDTO
  - `data` PutPromotionStatusCommandDTO
    - `message` string, nullable: Mensagem de confirmação ou o motivo da recusa.
    - `success` boolean: `true` quando o status foi alterado.

## Other responses

- `400`: `active` ausente, datas incompletas ou inválidas, ou promoção expirada sem nova data. O motivo vem em `displayMessage`.
- `401`: Token ausente, inválido ou expirado (SESSION_INVALID), ou sem a permissão exigida (UNAUTHORIZED).
- `404`: Promoção inexistente ou excluída.
- `409`: Conflito com o estado atual.
- `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)