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
}