INinstantly
AISalesAgent

Get an AI Sales Agent

Changed on

Retrieve a single AI Sales Agent with its full configuration.

Requires one of the following scopes: ai_sdr:read, ai_sdr:all, all:read, all:all

get/api/v2/ai-agents/sales/{id}

Request

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

Path parameters

idstring uuid required
Example:01a19e6f-7b46-75a1-8341-548c7c2668b7

AI Sales Agent ID

Response

The requested AI Sales Agent

idstring uuid required

Unique identifier for the AI Sales Agent

workspace_idstring uuid required

Workspace ID that owns this AI Sales Agent

namestring required

Name of the AI Sales Agent

descriptionstring nullable

Description of the AI Sales Agent

type'website' | 'pitch_deck'

The type of business details extraction method used (website scraping or pitch deck). Required unless memory_from_workspace is true.

inputstring nullable

The input used for creation: URL for website scraping or text content for pitch deck extraction. Required unless memory_from_workspace is true.

status-1 | 0 | 1 required

Status of the AI Sales Agent

created_bystring uuid nullable

User ID who created the AI Sales Agent

master_lead_list_idstring uuid nullable

ID of the master lead list associated with this AI Sales Agent

initial_scrape_readyboolean required

Indicates whether the initial website scrape has been completed

agent_type2 | 4 | 7 | 8 | 9 | 10

The agent type. 2 = Sales Agent, 4 = Affiliate Agent, 7 = Recruiting Agent, 8 = Investment Agent, 9 = User Research Agent, 10 = Partnership Agent. Defaults to 2 (Sales Agent) if not provided.

self_improvementboolean nullable

When enabled, the agent learns from past campaign performance to iteratively improve its outreach strategy.

timestamp_createdstring date-time required

Timestamp when the AI Sales Agent was created

timestamp_updatedstring date-time required

Timestamp when the AI Sales Agent was last updated

timestamp_last_actionstring date-time nullable

Timestamp of the last action taken by the AI Sales Agent

timestamp_last_decisionstring date-time nullable

Timestamp of the last decision made by the AI Sales Agent

next_decision_timestring date-time nullable

Timestamp of the next scheduled decision time

Example response

{
  "id": "01a19e6f-3fa9-7755-9afc-3b90a93e9029",
  "workspace_id": "01a19e6f-3fa9-7755-9afc-3b91fa956be6",
  "name": "Enterprise Outreach Agent",
  "description": "Targets enterprise companies in tech sector",
  "type": "website",
  "input": "https://example.com",
  "status": 1,
  "config": {
    "position_details": "Senior Software Engineer - Full-stack development with React and Node.js",
    "investment_details": "Seed-stage B2B SaaS companies in fintech with strong recurring revenue",
    "research_details": "Interviewing product managers at mid-size tech companies about onboarding workflows",
    "partnership_details": "Looking for B2B companies from pharma for a partnership in distributing our product",
    "enrichment_settings": {
      "enrichment_limit_per_run": 30,
      "signal_targeting_enabled": true,
      "signal_targeting_categories": [
        "website_funding"
      ]
    },
    "outreach_settings": {
      "opt_out_settings": {
        "text_opt_out_enabled": true
      }
    }
  },
  "created_by": "01a19e6f-3fa9-7755-9afc-3b92c5f0d866",
  "master_lead_list_id": "01a19e6f-3fa9-7755-9afc-3b9352b34c3a",
  "agent_type": 2,
  "timestamp_created": "2026-11-02T22:44:13.353Z",
  "timestamp_updated": "2026-11-02T22:44:13.353Z",
  "timestamp_last_action": "2026-11-02T22:44:13.353Z",
  "timestamp_last_decision": "2026-11-02T22:44:13.353Z",
  "next_decision_time": "2026-11-02T22:44:13.353Z"
}

Changes