Campaigns

Launch a campaign: activate + run the launch pipeline (alias /send)

Changed on

Marks the campaign ready: sets status: active and runs the full launch pipeline campaign-keyed (sender gate, duplicate auto-cancel, per-account scheduling). Idempotent on an already-active campaign.

Launch is "mark ready", never "force". There are NO override knobs: send windows, daily caps, spacing, and duplicate settings are the campaign's own persisted config, set through the agent, never per-call. POST /campaigns/{campaignId}/send is an alias. ?dryRun=true returns { dryRun: true, campaignId, wouldLaunch: true } with no writes.

post/campaigns/{campaignId}/launch

Request

  • Base URL
    https://origami.chat/api/v2
  • URL
    https://origami.chat/api/v2/campaigns/{campaignId}/launch
  • Auth
    HTTP bearer

Query parameters

dryRunboolean

Headers

Idempotency-Keystring

Transport-level replay protection: any v2 POST may send it (1-255 printable ASCII characters; UUIDs recommended). The first response for a key is recorded and replayed verbatim for retries with the same key + method/path/body for 24 hours; replayed responses carry the Idempotency-Replay: true response header. Reusing a key with a different request, or retrying while the original is still in flight, returns 409 IDEMPOTENCY_ERROR. 5xx responses are never recorded (the retry re-executes).

Response

The transition result, or the dryRun report.

OR

Changes