Skip to main content
POST
Create Turn

Path

string
required
Session id.

Body

string
required
One of file_write · file_delete · command_exec · git_commit · git_push · dependency_install · migration_run · bypass.
string
Human-readable summary (e.g. "Write file /src/server.ts" or "Run shell command: git push origin main").
string
Name of the tool the agent wants to call (e.g. Write, Edit, Bash).
object
Raw tool arguments. For Bash this typically includes command; for Write/Edit, file_path + content.

Response

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.