> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitl.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Wait for Turn

> Long-poll for the human decision on a 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

**id** `string` *required*

Session id.

**turn\_id** `string` *required*

Turn id.

## Query

**timeout** `integer` (default: 60)

Seconds to wait (max 300).

## Response

When resolved (status `200`):

```json theme={null}
{ "error": false, "msg": "turn resolved", "data": { "turn": { "human_decision": "approve", ... } } }
```

When still pending after timeout (status `408`):

```json theme={null}
{ "error": false, "msg": "timeout — turn still pending", "data": { "turn": { ... }, "pending": true } }
```

The typical plugin pattern is to call `/wait` in a loop until `turn.human_decision` is set.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.