Delete agent
Permanently deletes the agent and all of its data. This is a hard delete, not an archive — there is no recovery via the public API. Specifically, the call removes: the agent row; the agent's saved record on the upstream provider; the agent's calendar config and Google Calendar (if any); knowledge document links; prompt version history; appointments; and all conversations (call records, transcripts, recordings, analysis) tied to this agent. Leads owned by the agent are also deleted. Campaigns that referenced the agent survive but are orphaned (their agent_id is set to null). Returns 409 conflict if the agent has campaigns in scheduled, active, or paused status — stop those first. A second delete after success returns 404 because the row is gone.
Authorization: Bearer <api_key>. Create a key under Configuration → General → API Keys.Path parameters
- idstringrequiredUUID of the resource.
Response 200 OK
Agent deleted.
- deletedbooleanrequiredAlways
true. Confirms the agent was hard-deleted (not archived). The agent's call history, transcripts, recordings, and leads are gone with it; campaigns survive but become orphaned. See theDELETE /agents/{id}operation description for the full list.true
Errors
- 401UnauthorizedMissing, malformed, or invalid API key.
- 403ForbiddenWorkspace unavailable, suspended, or paywalled.
- 404Not FoundResource not found in this workspace.
- 409ConflictRequest conflicts with current resource state.
- 429Too Many RequestsWorkspace request limit exceeded; shared across all its API keys.