Skip to main content
DELETE
Delete agent
Permanently deletes an agent. This action cannot be undone.

Overview

This endpoint removes an agent and, with it, every conversation that agent ran.

Use Cases

  • Remove Unused Agents: Clean up agents that are no longer needed
  • Archive Old Configurations: Permanently remove outdated agent configurations
  • Compliance: Delete agents for data retention compliance
  • Organization: Maintain a clean agent library

Permanent Deletion Behavior

Deleting an agent is irreversible, and it also deletes every conversation created with that agent, along with their transcripts, recordings and analyses.

Impact on Existing Conversations

Existing conversations do not survive. Deletion cascades from the agent to its conversations, so a completed call’s transcript and analysis go with the agent that ran it. Export anything you need first, or leave the agent in place — an unused agent costs nothing.

Company Isolation

You can only delete agents that belong to your API key’s company. Attempting to delete an agent from another company will result in a 403 Forbidden error.

Error Scenarios

  • 404 Not Found: Agent doesn’t exist or has already been deleted
  • 403 Forbidden: Agent belongs to a different company

Agents Resource Guide

Learn about agent management

List Agents

View all active agents

Create Agent

Create new agents

Authorizations

Authorization
string
header
required

API key for authentication using Bearer scheme

Path Parameters

id
string<uuid>
required

Query Parameters

companyId
string

Required for ATS API keys to specify which company to access. Ignored for standard company API keys.

Response

Deleted successfully

id
string<uuid>
required

Id of the deleted resource

deleted
enum<boolean>
required

Always true; a failed delete answers with an error status

Available options:
true
Example:

true