v1

latestOpenAPI 3.1.02026-07-17325265.6 KB
Sessions

Launch a draft session

Launch a draft session, transitioning it from draft to running state

post/sessions/{id}/launch

Path parameters

idstring required

Session ID

Request body

promptstring required

Initial prompt to send to Claude

createDirectoryIfNotExistsboolean

Create working directory if it doesn't exist

Response

Session launched successfully

Example response

{
  "data": {
    "id": "sess_abcdef123456",
    "run_id": "run_xyz789",
    "claude_session_id": "claude_sess_123",
    "parent_session_id": "sess_parent123",
    "query": "Help me refactor this code",
    "summary": "Refactored authentication module",
    "title": "My Important Task",
    "model": "sonnet",
    "model_id": "claude-opus-4-1-20250805",
    "working_dir": "/home/user/project",
    "additional_directories": [
      "~/.humanlayer/logs",
      "/var/log/myapp"
    ],
    "cost_usd": 0.05,
    "input_tokens": 1000,
    "output_tokens": 500,
    "cache_creation_input_tokens": 100,
    "cache_read_input_tokens": 50000,
    "effective_context_tokens": 51100,
    "context_limit": 168000,
    "duration_ms": 45000,
    "proxy_base_url": "https://openrouter.ai/api/v1",
    "proxy_model_override": "openai/gpt-oss-120b",
    "editor_state": "{\"content\":\"console.log(\\\"hello\\\");\",\"cursorPosition\":24}"
  }
}