Delete an AI Deliverability Agent
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
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
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.
"01a04400-9e16-7bf8-bfbe-8fab7be0e7ce"
Response
The deleted AI Deliverability Agent
The fields shared by every AI agent type
Unique identifier for the AI agent
"01a04400-572e-7c71-b21e-f2e0804b2f8a"
Name of the AI Agent
"Test AI Agent"
Status of the AI Agent
-1, 0, 1 1
Timestamp when the AI agent was created
"2026-08-27T16:14:28.142Z"
Timestamp when the AI agent was updated
"2026-08-27T16:14:28.142Z"
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.
copilot, fully_automatic, null "copilot"
Type of the AI Agent
1, 2, 3, 4, 6, 7, 8, 9, 10 1