Skip to main content
Sessions group related turns (proposed actions) by agent coding session. Each session is scoped to a user and a loop. Every turn routes to a human reviewer via the same mobile app that reviews regular HITL requests. Use Sessions when you’re running an AI coding agent (Claude Code, Codex CLI) that needs human oversight on file writes, shell commands, git actions, dependency changes, and migrations. For the product-level walk-through, see Sessions concept. For the ready-made Claude Code integration, see the Claude Code plugin guide.

​
Authentication

All endpoints require a Bearer API key in the Authorization header:
API keys are created at my.hitl.sh → API Keys.

​
Resources

  • Session — container for an agent coding run. Has status (active | paused | completed | abandoned), loop_id, context (repo/branch/commit/task), and a running turn_count.
  • Turn — a proposed action inside a session. Has action_type, proposed_tool, proposed_args, a request_id (for the backing mobile-app record), and eventually human_decision + action_taken.

​
Endpoint map

​
Webhooks

Subscribe to turn.resolved via the Webhooks API to get notified whenever a reviewer acts on a turn.