Permanently cancel an internal Telegram campaign

Same gates as campaign creation, plus Idempotency-Key. Atomically compare-and-sets a scheduled, queued, sending or paused campaign to cancelled and stops every queued recipient. Idempotent (changed=false when already cancelled); irreversible — there is no un-cancel through REST. A recipient whose send had already crossed the Telegram submission boundary may still complete; the worker re-checks status immediately before every send. Takes no request body.

post/campaigns/{campaign_id}/cancel

Request

  • Base URL: https://gramclaw.com/api/v1
  • URL: https://gramclaw.com/api/v1/campaigns/{campaign_id}/cancel
  • Auth: HTTP bearer

Path parameters

campaign_idstring uuid required

Headers

Idempotency-Keystring required

Stable caller-generated identity for this exact mutation. Ambiguous operations are not retried.

Response

{ campaign: { id, status, cancelled_at }, changed }

Changes

No recorded changes to this operation across all 1 revision of this API.