Delete Messages from Conversation
curl --request DELETE \
--url https://api.bland.ai/v1/sms/conversations/{id}/messages \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"message_ids": [
"<string>"
]
}
'import requests
url = "https://api.bland.ai/v1/sms/conversations/{id}/messages"
payload = { "message_ids": ["<string>"] }
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({message_ids: ['<string>']})
};
fetch('https://api.bland.ai/v1/sms/conversations/{id}/messages', 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.bland.ai/v1/sms/conversations/{id}/messages",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_POSTFIELDS => json_encode([
'message_ids' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/sms/conversations/{id}/messages"
payload := strings.NewReader("{\n \"message_ids\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("DELETE", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
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.bland.ai/v1/sms/conversations/{id}/messages")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"message_ids\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/sms/conversations/{id}/messages")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"message_ids\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"message": "2 messages marked as deleted",
"deleted_count": 2
},
"errors": null
}
Messaging
Delete Messages from Conversation
Delete SMS conversations by their IDs.
DELETE
/
v1
/
sms
/
conversations
/
{id}
/
messages
Delete Messages from Conversation
curl --request DELETE \
--url https://api.bland.ai/v1/sms/conversations/{id}/messages \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"message_ids": [
"<string>"
]
}
'import requests
url = "https://api.bland.ai/v1/sms/conversations/{id}/messages"
payload = { "message_ids": ["<string>"] }
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({message_ids: ['<string>']})
};
fetch('https://api.bland.ai/v1/sms/conversations/{id}/messages', 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.bland.ai/v1/sms/conversations/{id}/messages",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_POSTFIELDS => json_encode([
'message_ids' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/sms/conversations/{id}/messages"
payload := strings.NewReader("{\n \"message_ids\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("DELETE", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
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.bland.ai/v1/sms/conversations/{id}/messages")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"message_ids\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/sms/conversations/{id}/messages")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"message_ids\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"message": "2 messages marked as deleted",
"deleted_count": 2
},
"errors": null
}
Enterprise Feature - SMS is only available on Enterprise plans. Contact your Bland representative for access.
Headers
string
required
Your API key for authentication.
Path Parameters
string
required
The ID of the conversation deleted.
Body Parameters
string[]
required
A list of message ID integers to mark as deleted. Must not be empty.
Response
object
Object containing confirmation and the count of messages deleted.
string
A success message indicating how many messages were marked as deleted.
number
The number of messages successfully marked as deleted.
null|array
null on success, or a list of error objects on failure.{
"data": {
"message": "2 messages marked as deleted",
"deleted_count": 2
},
"errors": null
}
Docs for agents: llms.txt
Was this page helpful?
⌘I