Cancel a send
Cancels a scheduled or queued send before it goes out, or STOPS any in-flight campaign send. A campaign in sending or paused is canceled the same way the in-app Stop button does it: the remaining recipients are never delivered while already-sent ones stay sent (every shape re-checks liveness at regular points mid-flight — smart per time bucket, gradual and plain blast at bounded chunk intervals — so a small tail may still deliver after the cancel lands). Idempotent — a send already canceled returns 200. A send already sent or failed, or a non-campaign (automation) send, returns 409 SEND_NOT_CANCELLABLE. Brand-scoped: an unknown / cross-brand sendId is 404.
Authorizations
Send your Brew API key as Authorization: Bearer brew_xxx.
Headers
Optional idempotency key for safe retries. Reusing the same key with the same request body returns the original response for 24 hours.
1 - 100The brand this request acts on. REQUIRED for organization-scoped credentials (otherwise 400 BRAND_ID_REQUIRED — there is no default brand); list ids with GET /v1/brands. Brand-scoped credentials may omit it, and sending a different brand returns 403 BRAND_SCOPE_MISMATCH. A brand outside your organization returns 404 BRAND_NOT_FOUND.
1 - 64Path Parameters
Send id returned by POST /v1/sends.
1 - 64"snd_8fK2mQ4p"