---
title: "Cancelar mensagem agendada"
method: POST
path: "/v1/message/{id}/cancel"
tags: ["Message"]
---

# Cancelar mensagem agendada

`POST /v1/message/{id}/cancel`

## Request

- Base URL: `https://api.liderhub.com.br`
- URL: `https://api.liderhub.com.br/v1/message/{id}/cancel`
- Auth: API key in header `x-company-key`

Cancela uma mensagem com status SCHEDULE, alterando para CANCELED. Mensagens que não estão agendadas ou já foram processadas/canceladas retornam 400. Só opera sobre mensagens do workspace da credencial.

## Path parameters

- `id` string, uuid, required

## Response `200`

Mensagem agendada cancelada com sucesso

- CancelScheduledMessageResponseDto
  - `id` string, uuid, required: UUID da mensagem cancelada
  - `deliveryStatus` string, required: Status após o cancelamento

## Other responses

- `400`: ID inválido ou mensagem não está com status SCHEDULE
- `401`: Não autorizado — chave de empresa inválida ou ausente
- `404`: Mensagem não encontrada neste workspace

## Changes

- **2026-11-03** `45d9c84fa0bc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/liderhub/apis/api-liderhub/changes/v1/message/:id/cancel/post.md)

---

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