Conversations

Cancel a queued send

Cancel a queued SMS, iMessage, or WhatsApp send. Repeat calls are idempotent.

await contiguity.conversations.cancel("text_abc");

This does not unsend a message. If the send is already in flight, it may still go out. Delivery-confirmed messages throw with status 400.

A successful cancel appends text.cancelled / imessage.cancelled / whatsapp.cancelled to the tracking timeline and fires the matching webhook once. See Cancel a queued send for retry backoff and other API details.

conversations.cancel(message)

string

required

Message ID to cancel (text_…, imessage_…, or whatsapp_…). First argument.

Response

boolean

Always true on success. Repeat calls are idempotent.

string

The cancelled message ID.

object

Request metadata: id, timestamp, api_version, object.

{
  "cancelled": true,
  "msg_id": "text_abc",
  "metadata": {
    "id": "req_…",
    "timestamp": "…",
    "api_version": "v2026.7.29",
    "object": "response"
  }
}

Errors

Throws ContiguityError.

Status	When
`400`	Delivery was already confirmed. In-flight sends cannot be unsent.
`401` / `403`	Bad or unauthorized token
`404`	Message not found / not owned by the caller

import { ContiguityError } from "contiguity";

try {
  await contiguity.conversations.cancel("text_abc");
} catch (e) {
  if (e instanceof ContiguityError) {
    console.error(e.status, e.message);
  }
}

Getting Started

SDK Documentation by Product

SDK Documentation by Language

Cancel a queued send

conversations.cancel(message)

Response

Errors

​Cancel a queued send

​conversations.cancel(message)

​Response

​Errors

Cancel a queued send

conversations.cancel(message)

Response

Errors