v1

latestOpenAPI 3.1.02026-07-17325265.6 KB

Sessions

List sessions

List all sessions with optional filtering. By default returns only leaf sessions (sessions with no children). Set leavesOnly=false to get all sessions.

get/sessions

Query parameters

leavesOnlyboolean

Return only leaf sessions (sessions with no children)

filter'normal' | 'archived' | 'draft'

normal: non-archived, non-draft sessions
archived: archived sessions only
draft: draft sessions only When omitted, returns ALL sessions (no filtering)

Filter sessions by type

Response

List of sessions

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}"
    }
  ]
}