INinstantly
AISalesAgent

List AI Sales Agents

Changed on

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

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

Query parameters

limitinteger
Example:10

The number of items to return

starting_afterstring uuid
Example:01a19e6f-8fd2-736d-b898-7e0c9175caf4

The ID of the last item in the previous page - used for pagination. You can use the value of the next_starting_after field from the previous response.

status-1 | 0 | 1
Example:1

Filter by agent status.

searchstring
Example:Outbound US

Filter agents whose name contains this text (case-insensitive).

agent_type2 | 4 | 7 | 8 | 9 | 10
Example:2

Filter by a single outbound agent type. 2 = Sales, 7 = Recruiting, 8 = Investment, 9 = User Research, 10 = Partnership.

Response

The AI Sales Agents of the workspace

next_starting_afterstring uuid

Pass as starting_after to fetch the next page. Absent on the last page.

Example response

{
  "items": [
    {
      "id": "01a19e6f-50da-736c-a0d9-ba76b6488c52",
      "workspace_id": "01a19e6f-50da-736c-a0d9-ba779554b7d1",
      "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-50da-736c-a0d9-ba7878c1d666",
      "master_lead_list_id": "01a19e6f-50da-736c-a0d9-ba7925c66ddb",
      "agent_type": 2,
      "timestamp_created": "2026-11-02T22:44:17.754Z",
      "timestamp_updated": "2026-11-02T22:44:17.754Z",
      "timestamp_last_action": "2026-11-02T22:44:17.754Z",
      "timestamp_last_decision": "2026-11-02T22:44:17.754Z",
      "next_decision_time": "2026-11-02T22:44:17.754Z"
    }
  ],
  "next_starting_after": "01a19e6f-8fd2-736d-b898-7e0d6e7b8148"
}

Changes