INinstantly
AISalesAgent

Delete an AI Sales Agent

Changed on

Delete an AI Sales Agent. Returns the core fields of the deleted agent. Fails with a conflict while campaigns are still linked to the agent.

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

delete/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-7f37-7747-b1eb-5c234d935f81

AI Sales Agent ID

Response

The deleted AI Sales Agent

idstring uuid required

Unique identifier for the AI agent

type1 | 2 | 3 | 4 | 6 | 7 | 8 | 9 | 10 | 11 nullable

Type of the AI Agent

namestring required

Name of the AI Agent

status-1 | 0 | 1 required

Status of the AI Agent

timestamp_createdstring required

Timestamp when the AI agent was created

timestamp_updatedstring required

Timestamp when the AI agent was updated

configuration_mode'copilot' | 'fully_automatic' | 'null' nullable required

How much autonomy the agent runs with. Null for agent types that have no autonomy setting, and for agents whose mode is not configured yet.

Example response

{
  "id": "01a19e6f-5074-7a90-9d10-535a367c0bf1",
  "type": 1,
  "name": "Test AI Agent",
  "status": 1,
  "timestamp_created": "2026-11-02T22:44:17.652Z",
  "timestamp_updated": "2026-11-02T22:44:17.652Z",
  "configuration_mode": "copilot"
}

Changes