Delete Run

Delete a run by ID.

For threads using DeltaChannel, deleting a run skips checkpoint deletion and removes only the run record. The run’s checkpoints may store delta writes that later checkpoints depend on for state reconstruction, so they are preserved. To reclaim checkpoint storage on delta-channel threads, use Prune Threads instead.

DELETE /threads/{thread_id}/runs/{run_id}

Delete Run

cURL

curl --request DELETE \
  --url https://api.example.com/threads/{thread_id}/runs/{run_id}

404

{
  "detail": "<string>"
}

Path Parameters

thread_id · string<uuid> · required

The ID of the thread.

run_id · string<uuid> · required

The ID of the run. For threads using DeltaChannel, deleting a run skips checkpoint deletion and removes only the run record. The run's checkpoints may store delta writes that later checkpoints depend on for state reconstruction, so they are preserved. To reclaim checkpoint storage on delta-channel threads, use Prune Threads instead.

Response

200

application/json

Success