Prune Threads

Prune threads by ID. The ‘delete’ strategy removes threads entirely. The ‘keep_latest’ strategy prunes old checkpoints but keeps threads and their latest state.

For threads using DeltaChannel, the ‘keep_latest’ strategy retains the minimum set of ancestor checkpoints required to replay and reconstruct the latest delta channel state. These retained checkpoints retain only delta channel blobs, so they can no longer be used directly to fork the thread or time travel to those points.

POST /threads/prune

Prune Threads

cURL

curl --request POST \
  --url https://api.example.com/threads/prune \
  --header 'Content-Type: application/json' \
  --data '
{
  "thread_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "strategy": "delete"
}
'

200

{
  "pruned_count": 123
}

Body

application/json

Payload for pruning threads.

thread_ids · string<uuid>[] · required

List of thread IDs to prune.

strategy · enum<string> · default: delete

The prune strategy. 'delete' removes threads entirely. 'keep_latest' prunes old checkpoints but keeps threads and their latest state.

For threads using DeltaChannel, 'keep_latest' retains the minimum set of ancestor checkpoints required to replay and reconstruct the latest delta channel state. These retained checkpoints retain only delta channel blobs, so they can no longer be used directly to fork the thread or time travel to those points.

Available options: delete, keep_latest

Response

200

application/json

Success

Response from pruning threads.

pruned_count · integer · required

Number of threads successfully pruned.