Delete Conversation

Delete a specific conversation and all of its associated messages. This action is permanent.

DELETE /v1/sms/conversations/{id}

Delete Conversation

cURL

curl --request DELETE \
  --url https://api.bland.ai/v1/sms/conversations/{id} \
  --header 'authorization: <authorization>'

Response

{
  "data": {
    "message": "Conversation and all associated messages deleted successfully"
  },
  "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 to delete.

Response

data · object

Confirmation message indicating the conversation and messages were deleted.

data.message · string

A human-readable success message.

errors · null|array

null on success, or a list of error objects on failure.

Response

{
  "data": {
    "message": "Conversation and all associated messages deleted successfully"
  },
  "errors": null
}