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>"
  ]
}'
{
  "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
}