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 (VAPI/Retell/Inspra); 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 in the Inspra dashboard under Workspace Settings → 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.