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
}

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
}