Delete Agent

DELETE

https://platform-api.convirza.com/v3/ai-voice-agents/{id}

AI Voice Agents

Last modified:2026-07-24 13:10:44

Permanently deletes an AI voice agent and all of its associated data — configuration, knowledge base files, and settings.

This action is irreversible. Once deleted:

The agent is immediately removed from all active call routing.

Knowledge base files are deleted from storage.

The agent no longer appears in any listing or report.

Any Twilio number previously associated with this agent must be manually reassigned.

Before deleting
Ensure the agent is not currently handling live calls and is not the primary agent for any active tracking number. Consider deactivating the agent first using PATCH with { "status": "inactive" } to verify no disruption before permanent deletion.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

Agent deleted successfully

Bodyapplication/json

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request DELETE 'https://platform-api.convirza.com/v3/ai-voice-agents/{id}' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "code": 200,
    "message": "Resource deleted successfully",
    "data": null,
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-03-29T12:00:00.000Z"
}

Modified at 2026-07-24 13:10:44

Get Agent Details

Assigned Numbers