PATCH Ativar ou Desativar Desconto
Desativa um desconto.
Autenticação necessária
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Permissão necessária
Exige a permissão update_discounts.
Endpoint
PATCH https://api-dev.imagemais.com.br/api/finances/discounts/{id}/status
Parâmetros de Rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID do desconto |
Requisição
curl -X 'PATCH' \
'https://api-dev.imagemais.com.br/api/finances/discounts/1/status' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'
Respostas
200 Sucesso
Inverte o isActive do desconto (ativo ↔ inativo). A resposta traz o desconto como estava antes da troca — para saber o novo estado, inverta o isActive retornado ou busque o desconto de novo.
{
"data": {
"id": 3,
"name": "Agendamento",
"description": "Desconto de agendamento",
"percentage": null,
"fixed": "10",
"isActive": true,
"expirationDate": null,
"isEveryone": false,
"procedures": [
{
"id": 18,
"name": "Consulta",
"price": "100"
}
],
"createdAt": "2026-08-21T23:58:32.077Z",
"updatedAt": "2026-08-21T23:58:32.077Z"
}
}
403 Sem permissão
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}
404 Não encontrado
{
"message": "Desconto não encontrado",
"error": "Not Found",
"statusCode": 404
}