On this page

POST/campaigns/:id/leads/:leadId/agent

Pause or resume the AI agent’s auto-replies for one lead. Pause cancels queued agent replies. Re-sending the same state is safe.

0 credits. Rate class: campaign_control (default 20/min).

Request

POST /campaigns/camp_abc/leads/lead_1/agent
X-API-Key: sk_live_...
Content-Type: application/json

{ "paused": true }

Field	Required	Notes
`paused`	Yes	`true` = pause · `false` = resume

{
  "campaignId": "camp_abc",
  "leadId": "lead_1",
  "paused": true,
  "cancelledTasks": 2
}

validation_error · not_found · conflict (e.g. resume refused for excluded lead) · rate_limited · upstream_unavailable

Tool: pause_resume_agent.