Skip to main content
GET
Wait for Turn
Holds the connection until either the turn is resolved or 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 (status 200):
When still pending after timeout (status 408):
The typical plugin pattern is to call /wait in a loop until turn.human_decision is set.