Agents
Delete Agent
Permanently delete an agent from your account
DELETE
/
api
/
agents
/
{agent_id}
curl -X DELETE "https://api.vaanivoice.ai/api/agents/7ec4155e-0e62-440a-b983-5974f7697854" \
-H "X-API-Key: vaani_<your_key>"
const response = await fetch("https://api.vaanivoice.ai/api/agents/7ec4155e-0e62-440a-b983-5974f7697854", {
method: "DELETE",
headers: {
"X-API-Key": "vaani_<your_key>",
},
});
const data = await response.json();
console.log(data);
import requests
response = requests.delete(
"https://api.vaanivoice.ai/api/agents/7ec4155e-0e62-440a-b983-5974f7697854",
headers={
"X-API-Key": "vaani_<your_key>",
},
)
print(response.json())
from vaani_sdk import VaaniClient
with VaaniClient(api_key="vaani_<your_key>") as client:
# Delete by UUID or name
result = client.agents.delete("7ec4155e-0e62-440a-b983-5974f7697854")
print(result["message"]) # "Agent deleted successfully"
{
"message": "Agent deleted successfully"
}
{
"status_code": 404,
"error": "Not Found",
"message": "Agent not found",
"code": "NOT_FOUND",
"path": "/api/agents/00000000-0000-0000-0000-000000000000",
"timestamp": "2026-11-04T06:52:01.909247Z",
"request_id": "3f1a9be8-bc90-4c78-ac58-916cc23e4963"
}
{
"status_code": 403,
"error": "Forbidden",
"message": "Access denied",
"path": "/api/agents/7ec4155e-0e62-440a-b983-5974f7697854",
"timestamp": "2026-11-04T06:52:01.909247Z",
"request_id": "3f1a9be8-bc90-4c78-ac58-916cc23e4963"
}
Delete Agent
Permanently delete an agent by UUID or name. This action stops any active agent instances, cleans up configurations, and unassigns related resources.Deletion is permanent. Once an agent is deleted, its configuration and assigned prompts cannot be recovered.
Path Parameters
Deleting an agent requires an admin (or super-admin) role. A key owned by a non-admin user gets
403 Forbidden. Errors use the standard envelope (code: "NOT_FOUND" / FORBIDDEN) and do not include a detail field. DELETE /api/delete-agent/{agent_id} is an alias of this endpoint.Request Example
curl -X DELETE "https://api.vaanivoice.ai/api/agents/7ec4155e-0e62-440a-b983-5974f7697854" \
-H "X-API-Key: vaani_<your_key>"
const response = await fetch("https://api.vaanivoice.ai/api/agents/7ec4155e-0e62-440a-b983-5974f7697854", {
method: "DELETE",
headers: {
"X-API-Key": "vaani_<your_key>",
},
});
const data = await response.json();
console.log(data);
import requests
response = requests.delete(
"https://api.vaanivoice.ai/api/agents/7ec4155e-0e62-440a-b983-5974f7697854",
headers={
"X-API-Key": "vaani_<your_key>",
},
)
print(response.json())
from vaani_sdk import VaaniClient
with VaaniClient(api_key="vaani_<your_key>") as client:
# Delete by UUID or name
result = client.agents.delete("7ec4155e-0e62-440a-b983-5974f7697854")
print(result["message"]) # "Agent deleted successfully"
Response
{
"message": "Agent deleted successfully"
}
{
"status_code": 404,
"error": "Not Found",
"message": "Agent not found",
"code": "NOT_FOUND",
"path": "/api/agents/00000000-0000-0000-0000-000000000000",
"timestamp": "2026-11-04T06:52:01.909247Z",
"request_id": "3f1a9be8-bc90-4c78-ac58-916cc23e4963"
}
{
"status_code": 403,
"error": "Forbidden",
"message": "Access denied",
"path": "/api/agents/7ec4155e-0e62-440a-b983-5974f7697854",
"timestamp": "2026-11-04T06:52:01.909247Z",
"request_id": "3f1a9be8-bc90-4c78-ac58-916cc23e4963"
}
⌘I
curl -X DELETE "https://api.vaanivoice.ai/api/agents/7ec4155e-0e62-440a-b983-5974f7697854" \
-H "X-API-Key: vaani_<your_key>"
const response = await fetch("https://api.vaanivoice.ai/api/agents/7ec4155e-0e62-440a-b983-5974f7697854", {
method: "DELETE",
headers: {
"X-API-Key": "vaani_<your_key>",
},
});
const data = await response.json();
console.log(data);
import requests
response = requests.delete(
"https://api.vaanivoice.ai/api/agents/7ec4155e-0e62-440a-b983-5974f7697854",
headers={
"X-API-Key": "vaani_<your_key>",
},
)
print(response.json())
from vaani_sdk import VaaniClient
with VaaniClient(api_key="vaani_<your_key>") as client:
# Delete by UUID or name
result = client.agents.delete("7ec4155e-0e62-440a-b983-5974f7697854")
print(result["message"]) # "Agent deleted successfully"
{
"message": "Agent deleted successfully"
}
{
"status_code": 404,
"error": "Not Found",
"message": "Agent not found",
"code": "NOT_FOUND",
"path": "/api/agents/00000000-0000-0000-0000-000000000000",
"timestamp": "2026-11-04T06:52:01.909247Z",
"request_id": "3f1a9be8-bc90-4c78-ac58-916cc23e4963"
}
{
"status_code": 403,
"error": "Forbidden",
"message": "Access denied",
"path": "/api/agents/7ec4155e-0e62-440a-b983-5974f7697854",
"timestamp": "2026-11-04T06:52:01.909247Z",
"request_id": "3f1a9be8-bc90-4c78-ac58-916cc23e4963"
}