DELETE
/
v2
/
threads
/
{threadId}
cURL
curl --request DELETE \
  --url https://api.langtail.com/v2/threads/{threadId} \
  --header 'X-API-Key: <x-api-key>'
{
  "id": "<string>",
  "object": "thread.deleted",
  "deleted": true
}
This endpoint softly removes a thread by its unique identifier. It marks the thread and all associated messages as deleted in the system, but does not permanently erase them.

Headers

​
X-API-Key
string
required

Your Langtail API Key

Example:

"<LANGTAIL_API_KEY>"

Path Parameters

​
threadId
string
required

The ID of the thread to delete.

Response

Successfully deleted thread

​
id
string
required

The unique identifier of the deleted thread.

​
object
string
required

The object type, which is always 'thread.deleted' for this response.

Example:

"thread.deleted"

​
deleted
boolean
required

Indicates that the thread was successfully deleted.

Example:

true