Docs
Open dashboard

Delete agent

DELETE/agents/{id}

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.

Requires Authorization: Bearer <api_key>. Create a key under Configuration → General → API Keys.

Path parameters

  • idstringrequired
    UUID of the resource.

Response 200 OK

Agent deleted.

  • deletedbooleanrequired
    Always 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 the DELETE /agents/{id} operation description for the full list.
    true

Errors

  • 401Unauthorized
    Missing, malformed, or invalid API key.
  • 403Forbidden
    Workspace unavailable, suspended, or paywalled.
  • 404Not Found
    Resource not found in this workspace.
  • 409Conflict
    Request conflicts with current resource state.
  • 429Too Many Requests
    Workspace request limit exceeded; shared across all its API keys.