Human-in-the-Loop Functionality: How to Pause Threads Mid-Run for Input?

[MePriyanshuHoo]

Issue with current functionality:
I couldn’t find a clear way in the API to pause a thread’s run midway, wait for user input, and then resume. This is problematic for workflows that require human intervention during execution, as there doesn’t seem to be a mechanism to handle this scenario.

For example:

• Endpoints like /threads/{thread_id}/runs/wait are designed to wait for final output but don’t seem to support pausing mid-run for input.
• /threads/{thread_id}/runs/stream streams output in real-time, but I’m not sure if it allows for dynamic input injection while the run is active.

Idea or request:
It would be helpful to have:

1. A way to pause a run at a specific stage, hold its state, and await input.
2. Documentation or examples showing how to provide input dynamically during a run.

[markokraemer]

Human in the Loop is achieved through tool call involving the human with the Thread Run. Or after the Thread Run has completed, user could add a message to the Thread. Which then can be run again.

[lakshyaag12]

Does this indicate that for HITL in one thread, we can make more than 1 run? Or should we continue with the same run in the same thread?

[hinthornw]

It's multiple runs for the same thread. When you interrupt, the state is checkpointed, so when you resume the thread, the logic can continue

[lakshyaag12]

Thanks @hinthornw!