Sessions
Wait for Turn
Long-poll for the human decision on a turn.
GET
Wait for Turn
Holds the connection until either the turn is resolved or
When still pending after timeout (status
The typical plugin pattern is to call
timeout seconds elapse, whichever comes first.
The endpoint also reconciles the backing HITL request before returning: if a reviewer responded via the mobile app (hitting the regular request-response flow instead of PUT /turns/:id), the server picks that up, maps it to a decision, resolves the turn, and returns the resolved turn in a single round-trip.
Path
string
required
Session id.
string
required
Turn id.
Query
integer
default:"60"
Seconds to wait (max 300).
Response
When resolved (status200):
408):
/wait in a loop until turn.human_decision is set.