INinstantly
AILeadFinderAgent

Resume an AI Lead Finder Agent

Changed on

Resume a paused AI Lead Finder Agent. The agent immediately checks whether its campaign needs a top-up.

Requires one of the following scopes: ai_agents:update, ai_agents:all, all:update, all:all

post/api/v2/ai-agents/lead-finder/{id}/resume

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/ai-agents/lead-finder/{id}/resume
  • Auth
    HTTP bearer

Path parameters

idstring uuid required
Example:01a19e6f-7b2d-76f8-bb5d-26307f076d81

AI Lead Finder Agent ID

Response

The resumed AI Lead Finder Agent

idstring uuid required

Unique identifier for the AI agent

organization_idstring uuid required

Organization ID

namestring required

Name of the AI Agent

type6 nullable

Type of the AI Agent

timestamp_createdstring required

Timestamp when the AI agent was created

timestamp_updatedstring required

Timestamp when the AI agent was updated

status-1 | 0 | 1 required

Status of the AI Agent

is_auto_createdboolean nullable

Whether the AI agent was auto-created

created_bystring uuid nullable

User ID who created the AI agent

descriptionstring nullable

Description of the AI agent

Example response

{
  "id": "01a19e6f-3f3f-728a-b9f7-cc9a6bd79d6f",
  "organization_id": "01a19e6f-3f3f-728a-b9f7-cc9bacd1ee51",
  "name": "Test AI Agent",
  "payload": {
    "campaign_id": "01a19e6f-3f3f-728a-b9f7-cc9897b36b71",
    "campaign_name": "Outbound US",
    "min_active_leads": 50,
    "on_exhaustion": "pause",
    "ai_enrichment_workflow": "custom:0198c2a4-3f1e-7000-8000-000000000000"
  },
  "type": 6,
  "timestamp_created": "2026-11-02T22:44:13.247Z",
  "timestamp_updated": "2026-11-02T22:44:13.247Z",
  "status": 1,
  "created_by": "01a19e6f-3f3f-728a-b9f7-cc9c85601055",
  "description": "Optional agent description"
}

Changes