--- title: "List AI Sales Agents" method: GET path: "/api/v2/ai-agents/sales" tags: ["AISalesAgent"] --- # List AI Sales Agents `GET /api/v2/ai-agents/sales` ## Request - Base URL: `https://api.instantly.ai` - URL: `https://api.instantly.ai/api/v2/ai-agents/sales` - Auth: HTTP bearer List the AI Sales Agents of the workspace, newest first. Requires one of the following scopes: `ai_sdr:read`, `ai_agents:read`, `ai_sdr:all`, `all:read`, `all:all` ## Query parameters - `limit` integer - `starting_after` string, uuid - `status` -1 | 0 | 1 - `search` string - `agent_type` 2 | 4 | 7 | 8 | 9 | 10 ## Response `200` The AI Sales Agents of the workspace - object - `items` AISalesAgent[], required: The list of AI Sales Agents - `id` string, uuid, required: Unique identifier for the AI Sales Agent - `workspace_id` string, uuid, required: Workspace ID that owns this AI Sales Agent - `name` string, required: Name of the AI Sales Agent - `description` string, 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. - `input` string, 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 - `config` object: Configuration for the AI Sales Agent including memory, enrichment settings, outreach settings, and autonomy settings. If not provided, default configuration will be used. - `memory` object: Business context and memory for the AI Sales Agent - `position_details` string: Position details for recruiting agents, describing the role, responsibilities, and requirements - `investment_details` string: Investment details for investment agents, describing the investment thesis and target companies - `research_details` string: Research details for user research agents, describing the research goals and target participants - `partnership_details` string: Partnership details for partnership agents, describing the partnership goals and target partners - `enrichment_settings` object: Settings for lead enrichment - `enrichment_limit_per_run` number: Maximum number of leads to enrich per run - `signal_targeting_enabled` boolean: Whether the agent puts leads with recent buying signals first. AI Sales Agents only; other agent types ignore it. Defaults to true when omitted. Signals rank rather than filter: when fewer signal-carrying leads are available than the agent's daily target, the remainder is filled with other leads matching the ICP, so this never reduces the number of leads sourced. Set to false to stop prioritizing signals; the stored categories are kept for when it is turned back on. - `signal_targeting_categories` string[]: Signal categories the agent prioritizes while signal targeting is on (AI Sales Agents only), each with a 90-day freshness window. Omit to use the default high-intent set (recent funding or acquisition, executive leadership change, pricing change, product launch, company expansion, buying intent on Reddit). An empty array prioritizes nothing; a non-empty array targets exactly those categories. - `outreach_settings` object: Settings for email outreach including campaign_schedule, email_list, email_tag_list, daily_limit, stop_on_reply, open_tracking, first_email_text_only, prioritize_new_leads, match_lead_esp - `opt_out_settings` object: Opt-out settings appended to outgoing emails - `text_opt_out_enabled` boolean: Append a plain-text opt-out line to every email - `autonomy_settings` object: Settings for AI Sales Agent autonomy including autopilot_mode, auto_reply_to_responses, and manual_leads_mode - `autopilot_mode` boolean: Enable autopilot mode for autonomous decision-making - `auto_reply_to_responses` boolean: Automatically respond to prospect replies with contextual messages - `manual_leads_mode` boolean: When true, automatic lead discovery is disabled and the user uploads leads manually - `created_by` string, uuid, nullable: User ID who created the AI Sales Agent - `master_lead_list_id` string, uuid, nullable: ID of the master lead list associated with this AI Sales Agent - `initial_scrape_ready` boolean, required: Indicates whether the initial website scrape has been completed - `agent_type` 2 | 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_improvement` boolean, nullable: When enabled, the agent learns from past campaign performance to iteratively improve its outreach strategy. - `timestamp_created` string, date-time, required: Timestamp when the AI Sales Agent was created - `timestamp_updated` string, date-time, required: Timestamp when the AI Sales Agent was last updated - `timestamp_last_action` string, date-time, nullable: Timestamp of the last action taken by the AI Sales Agent - `timestamp_last_decision` string, date-time, nullable: Timestamp of the last decision made by the AI Sales Agent - `next_decision_time` string, date-time, nullable: Timestamp of the next scheduled decision time - `next_starting_after` string, uuid: Pass as `starting_after` to fetch the next page. Absent on the last page. ## Other responses - `401`: This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked) - `402`: This request cannot be fulfilled because the workspace does not have an active paid plan - `404`: The requested resource was not found - `429`: You have exceeded the rate limit. Please check the rate limit docs for more information. ## Changes - **2026-11-03** `c781051105a8`: 1 info - endpoint added [Operation history](https://skmtc.dev/instantly/apis/api-explorer/changes/api/v2/ai-agents/sales/get.md) --- [API](https://skmtc.dev/instantly/apis/api-explorer.md) - [All operations](https://skmtc.dev/instantly/apis/api-explorer/llms.txt) - [OpenAPI document](https://skmtc.dev/instantly/apis/api-explorer/revisions/3daaa5f6b0be?raw)