Endpoint

Start campaign run

POST/api/public/v1/campaigns/{campaign_id}/runswrite

Start the full pipeline run for a campaign (prequalify, enrich, qualify, research, draft). Idempotent: if a run is already queued or running, returns it instead of stacking a second. Already-enriched speakers are not re-billed. Pass dry_run=true to get cost_preview (credits this run would spend) without starting anything. Poll get_run_status for progress.

Request

curl -X POST "https://sayintel.com/api/public/v1/campaigns/<campaign_id>/runs" \
  -H "Authorization: Bearer $SAYINTEL_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

Try it out

Try it outPOST/api/public/v1/campaigns/{campaign_id}/runswrite

API key

Sent as a bearer token to this site only, and kept in this tab's session storage. It is never written to disk or sent anywhere else.

campaign_id path

idempotency_key optional

dry_run, preview the cost without spending anything

Paste an API key to run.

Path parameters

Name	In	Type	Required	Description
campaign_id	path	string	yes	—

Body

Name	In	Type	Required	Description
dry_run	body	boolean	no	When true nothing is written, started, or spent. The tool returns only cost_preview so an agent can estimate credits first.
idempotency_key	body	string	no	Optional retry guard. Reusing the same key with the same arguments replays the first result instead of running the action twice; reusing it with different arguments is rejected.

Response

{
  "ok": true,
  "tool": "start_campaign_run",
  "kind": "write",
  "data": { ... },
  "error": null
}

Notes

Scope required: write. How scopes work.
Accepts Idempotency-Key. A retry with the same key replays the first result instead of repeating the work.
Accepts dry_run: true and always returns cost_preview before spending anything.
Same capability over MCP as the tool start_campaign_run. MCP setup.