INinstantly
AIDeliverabilityAgent

Pause accounts affected by a deliverability recommendation

Changed on

Pause active email accounts currently affected by the default agent's DNS-health or blocklist recommendation. The recommendation is revalidated before account statuses are changed. 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-affected-accounts

Request

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

Path parameters

idstring uuid required
Example:01a19e6f-7efd-75d1-a285-413774268b6f

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
affected_domain_countnumber required
paused_account_countnumber required
paused_managed_account_countnumber required
paused_self_managed_account_countnumber required

Example response

{
  "item": {
    "id": "01a19e6f-7efd-75d1-a285-413774268b6f",
    "organization_id": "01a19e6f-7efd-75d1-a285-413774268b6f",
    "agent_id": "01a19e6f-7efd-75d1-a285-413774268b6f",
    "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:29.565Z",
    "timestamp_updated": "2026-11-02T22:44:29.565Z",
    "completed_at": "2026-11-02T22:44:29.565Z",
    "dismissed_at": "2026-11-02T22:44:29.565Z",
    "expires_at": "2026-11-02T22:44:29.565Z"
  },
  "affected_account_count": 2,
  "affected_domain_count": 1,
  "paused_account_count": 2,
  "paused_provider_counts": {
    "custom_imap_smtp": 1,
    "google": 1,
    "microsoft": 1,
    "airmail": 1,
    "other": 1
  },
  "paused_self_managed_account_count": 2
}

Changes