DELETE
/
v1
/
sms
/
conversations
/
{id}
/
messages
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
}