AIDeliverabilityAgent

Pause campaign sending for affected accounts

Changed on

Pause campaign sending for 14 days on self-managed accounts affected by the default agent's bounce-health or warmup-score recommendation. Calling this endpoint for an already completed feed item is idempotent.

Requires all of the following scope groups:

  • One of ai_agents:update, ai_agents:all, all:update, all:all
  • One of accounts:update, accounts:all, all:update, all:all
post/api/v2/ai-agents/deliverability/feed-items/{id}/pause-campaign-sending

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/ai-agents/deliverability/feed-items/{id}/pause-campaign-sending
  • Auth
    HTTP bearer

Path parameters

idstring uuid required
Example:01a19e6f-7b0a-7411-b306-dc53473144f0

Deliverability Agent feed item ID. Retrieve feed items from GET /api/v2/ai-agents/deliverability/{id}/feed-items, using the agent ID returned by GET /api/v2/ai-agents/deliverability.

Response

Default Response

affected_account_countnumber required
paused_account_countnumber required
already_paused_account_countnumber required
managed_account_countnumber required
ready_made_account_countnumber required
pause_sending_campaigns_untilstring date-time required
duration_daysnumber required

Example response

{
  "item": {
    "id": "01a19e6f-7b0a-7411-b306-dc53473144f0",
    "organization_id": "01a19e6f-7b0a-7411-b306-dc53473144f0",
    "agent_id": "01a19e6f-7b0a-7411-b306-dc53473144f0",
    "source_activity_id": "campaign",
    "feed_code": "workspace_settings_recommendation",
    "kind": "recommendation",
    "status": "todo",
    "severity": "warning",
    "priority": 100,
    "subject_type": "campaign",
    "subject_id": "campaign",
    "subject_name": "campaign",
    "action_code": "campaign",
    "action_status": "campaign",
    "dedupe_key": "workspace_settings_recommendation:workspace:01956fbd-0eb1-72db-a565-82977a586084",
    "timestamp_created": "2026-11-02T22:44:28.554Z",
    "timestamp_updated": "2026-11-02T22:44:28.554Z",
    "completed_at": "2026-11-02T22:44:28.554Z",
    "dismissed_at": "2026-11-02T22:44:28.554Z",
    "expires_at": "2026-11-02T22:44:28.554Z"
  },
  "affected_account_count": 7,
  "paused_account_count": 5,
  "already_paused_account_count": 2,
  "managed_account_count": 1,
  "ready_made_account_count": 2,
  "pause_sending_campaigns_until": "2026-11-02T22:44:28.554Z",
  "duration_days": 14
}

Changes