Skip to main content
DELETE
https://api.bland.ai
/
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>"
  ]
}
'
{
  "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

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
id
string
required
The ID of the conversation deleted.

​
Body Parameters

​
message_ids
string[]
required
A list of message ID integers to mark as deleted. Must not be empty.

​
Response

​
data
object
Object containing confirmation and the count of messages deleted.
​
data.message
string
A success message indicating how many messages were marked as deleted.
​
data.deleted_count
number
The number of messages successfully marked as deleted.
​
errors
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
}