Tasks — mailing campaign lifecycle

TL;DR for agents: Lifecycle: POST /api/tasks/:id/start | /pause | /stop | /restart. Insight: GET /api/tasks/:id/analytics (delivery / error rate / speed) and /monitor (live items by status). Items: GET /api/tasks/:id/items. Errors: /errors. Circuit breaker: /circuit-breaker.
Plain-text mirrors: /llms.txt · /tasks-campaigns.md

List tasks (mailing campaigns)

curl -s "https://api.live-direct-marketing.online/api/tasks?status=ACTIVE&pageSize=10" \
  -H "Authorization: Bearer $LDM_KEY"

Start / pause / stop / restart

Scope: tasks:write. restart re-queues errored items; stop is a hard halt (not resumable).

# start (required: status=APPROVED|DRAFT_APPROVED)
curl -s -X POST "https://api.live-direct-marketing.online/api/tasks/$T/start" -H "Authorization: Bearer $LDM_KEY"

# pause / stop / restart
curl -s -X POST "https://api.live-direct-marketing.online/api/tasks/$T/pause"   -H "Authorization: Bearer $LDM_KEY"
curl -s -X POST "https://api.live-direct-marketing.online/api/tasks/$T/stop"    -H "Authorization: Bearer $LDM_KEY"
curl -s -X POST "https://api.live-direct-marketing.online/api/tasks/$T/restart" -H "Authorization: Bearer $LDM_KEY"

Analytics — delivery rate, error rate, speed

Scope: tasks:read. Returns counts per item-status (PENDING/PROCESSING/DONE/ERROR/SKIPPED), deliveryRate, errorRate, durationSec, speedPerHour.

curl -s "https://api.live-direct-marketing.online/api/tasks/$T/analytics" \
  -H "Authorization: Bearer $LDM_KEY"

Live monitor (items as they progress)

curl -s "https://api.live-direct-marketing.online/api/tasks/$T/monitor" \
  -H "Authorization: Bearer $LDM_KEY"

Errors & circuit breaker (auto-pause on AI / bounce thresholds)

curl -s "https://api.live-direct-marketing.online/api/tasks/$T/errors"          -H "Authorization: Bearer $LDM_KEY"
curl -s "https://api.live-direct-marketing.online/api/tasks/$T/circuit-breaker" -H "Authorization: Bearer $LDM_KEY"