> ## 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.

# Create Turn

> Propose an action. Creates a turn + a backing HITL request + dispatches push to loop reviewers.

## Path

**id** `string` *required*

Session id.

## Body

**action\_type** `string` *required*

One of `file_write` · `file_delete` · `command_exec` · `git_commit` · `git_push` · `dependency_install` · `migration_run` · `bypass`.

**agent\_prompt** `string`

Human-readable summary (e.g. `"Write file /src/server.ts"` or `"Run shell command: git push origin main"`).

**proposed\_tool** `string`

Name of the tool the agent wants to call (e.g. `Write`, `Edit`, `Bash`).

**proposed\_args** `object`

Raw tool arguments. For `Bash` this typically includes `command`; for `Write`/`Edit`, `file_path` + `content`.

## Response

**data.turn** `object`

The created turn. `turn.request_id` is set to the backing HITL request id — that request is what renders in the mobile reviewer app.

## Side effects

* Creates a HITL `request` in the session's loop with `response_type=single_select`, options `[approve, modify, reject, escalate]`. Priority is `high` for destructive action types and `medium` otherwise.
* Sends FCM push to every active loop member's device.

```json 201 Created theme={null}
{
  "error": false,
  "msg": "turn created",
  "data": {
    "turn": {
      "id": "663f9...",
      "session_id": "663f8...",
      "turn_number": 4,
      "request_id": "663fa...",
      "action_type": "git_push",
      "agent_prompt": "Run shell command: git push origin preview",
      "proposed_tool": "Bash",
      "proposed_args": { "command": "git push origin preview" },
      "created_at": "2026-04-23T18:14:22Z"
    }
  }
}
```


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