Agent versions
Delete agent version API
Delete a Bolna voice agent version that isn’t live. Past calls on it keep their data.
DELETE
/
v2
/
agent
/
{agent_id}
/
versions
/
{agent_version_id}
cURL
curl --request DELETE \
--url https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"message": "Agent version deleted successfully"
}{
"message": "Agent version not found"
}{
"message": "The live version can't be deleted. Make another version live first."
}Deletes a version and every save under its name. It’s no longer listed, readable or callable, and its name becomes free to use again.
Executions that ran on the version keep their transcripts, recordings and data.
The live version returns
409. Make another version live first, then delete it.Was this page helpful?
⌘I
cURL
curl --request DELETE \
--url https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bolna.ai/v2/agent/{agent_id}/versions/{agent_version_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"message": "Agent version deleted successfully"
}{
"message": "Agent version not found"
}{
"message": "The live version can't be deleted. Make another version live first."
}
