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.

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.

Available options: delete, keep_latest

Response

200

application/json

Success

Response from pruning threads.

pruned_count · integer · required

Number of threads successfully pruned.