Skip to main content
DELETE
/
api
/
threads
/
{threadId}
curl -X DELETE https://your-worker.workers.dev/api/threads/550e8400-e29b-41d4-a716-446655440000

{
  "success": true,
  "threadId": "550e8400-e29b-41d4-a716-446655440000",
  "deletedThreadIds": [
    "4dcf9e6e-9b72-4435-bf1a-b402f488f012",
    "c3ba3a6a-0cc7-4f90-a8e8-9cd664f9fe11",
    "550e8400-e29b-41d4-a716-446655440000"
  ],
  "deletedCount": 3,
  "message": "Thread and subthreads deleted successfully"
}
Deletes a thread and its full descendant tree (all subthreads), including all associated messages and thread storage.
This action is irreversible. The selected thread and all descendant subthreads are permanently deleted.
​
threadId
string
required
The unique thread identifier (UUID)
​
success
boolean
required
Whether the deletion was successful
​
threadId
string
required
The root thread ID that was requested for deletion
​
deletedThreadIds
array[string]
required
Thread IDs deleted in child-first order
​
deletedCount
number
required
Total number of deleted threads (root + descendants)
curl -X DELETE https://your-worker.workers.dev/api/threads/550e8400-e29b-41d4-a716-446655440000

{
  "success": true,
  "threadId": "550e8400-e29b-41d4-a716-446655440000",
  "deletedThreadIds": [
    "4dcf9e6e-9b72-4435-bf1a-b402f488f012",
    "c3ba3a6a-0cc7-4f90-a8e8-9cd664f9fe11",
    "550e8400-e29b-41d4-a716-446655440000"
  ],
  "deletedCount": 3,
  "message": "Thread and subthreads deleted successfully"
}