INinstantly
AIDeliverabilityAgent

Delete an AI Deliverability Agent

Changed on

Delete an AI Deliverability Agent, removing its activity history and any queued runs. Returns the core fields of the deleted agent. Deploying again creates a fresh agent.

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

delete/api/v2/ai-agents/deliverability/{id}

Request

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

Path parameters

idstring uuid required
Example:01a19e6f-7efd-75d1-a285-413774268b6f

AI Deliverability Agent ID. Call GET /api/v2/ai-agents/deliverability and use the returned agent.id value to retrieve the workspace default agent ID.

Response

The deleted AI Deliverability 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