Skip to main content
POST
Prune Threads

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
sync_checkpoint_delete
boolean
default:false

If true, delete checkpoints before responding instead of deferring them to background deletion. Use when thread data must be gone on return.

Response

Success

Response from pruning threads.

pruned_count
integer
required

Number of threads successfully pruned.