HTTP API-справка

{
"query": "Find SaaS companies in Berlin with 10-50 employees",
"output_dir": "session-001"
}

{
"id": "sess_a1b2c3d4",
"status": "running",
"query": "Find SaaS companies in Berlin...",
"output_dir": "./results/session-001"
}

{
"sessions": [
  {
    "id": "sess_a1b2c3d4",
    "query": "Find SaaS companies in Berlin...",
    "status": "completed",
    "output_dir": "./results/session-001",
    "total_tokens": 42000,
    "total_agents": 3,
    "created_at": "2026-08-07T10:30:00Z",
    "updated_at": "2026-08-07T10:35:00Z",
    "active": false
  },
  {
    "id": "sess_e5f6g7h8",
    "query": "Analyze competitor pricing...",
    "status": "running",
    "output_dir": "./results/session-002",
    "total_tokens": 18000,
    "total_agents": 2,
    "created_at": "2026-08-07T11:00:00Z",
    "updated_at": "2026-08-07T11:02:00Z",
    "active": true
  }
],
"count": 2
}

{
"id": "sess_a1b2c3d4",
"query": "Find SaaS companies in Berlin...",
"status": "running",
"output_dir": "./results/session-001",
"total_tokens": 42000,
"total_agents": 3,
"created_at": "2026-08-07T10:30:00Z",
"updated_at": "2026-08-07T10:31:00Z",
"active": true
}

{
"id": "sess_a1b2c3d4",
"status": "cancelled"
}

{
"message": "Focus only on companies with Series A funding"
}

{
"id": "sess_a1b2c3d4",
"steered": true,
"message": "Instruction delivered to session sess_a1b2c3d4"
}

{
"session_id": "sess_a1b2c3d4",
"status": "completed",
"summary": "Found 3 SaaS companies in Berlin matching criteria.",
"output_dir": "./results/session-001",
"total_tokens": 42000,
"total_agents": 3,
"findings": [
  {
    "file": "./results/session-001/techcorp.md",
    "content": "TechCorp GmbH — B2B SaaS, 25 employees, Series A 2025"
  }
]
}

const ws = new WebSocket('ws://localhost:8080/api/v1/ws?api_key=sk-fathom-...');
ws.onmessage = (event) => console.log(JSON.parse(event.data));

{
"source": "github",
"event_type": "issues.opened",
"payload": { "issue": { "number": 42, "title": "Memory leak in agent" } }
}

data: {"type":"agent_spawned","agent_id":"agent_x1y2z3","role":"web-researcher"}

data: {"type":"finding","agent_id":"agent_x1y2z3","title":"TechCorp GmbH","confidence":0.92}

data: {"type":"session_completed","session_id":"sess_a1b2c3d4"}

{
"agents": [
  {
    "id": "agent_x1y2z3",
    "session_id": "sess_a1b2c3d4",
    "task": "Research web presence of SaaS companies",
    "status": "completed",
    "depth": 0,
    "tokens_used": 18420
  }
],
"count": 1
}

{
"id": "agent_x1y2z3",
"session_id": "sess_a1b2c3d4",
"parent_id": null,
"task": "Research web presence of SaaS companies",
"role": "web-researcher",
"depth": 0,
"status": "completed",
"tokens_used": 18420,
"created_at": "2026-08-07T10:30:01Z",
"completed_at": "2026-08-07T10:30:42Z"
}

{"request_id": "ctrl_abc123", "text": "Focus on Series B companies"}

{"answered": true, "request_id": "ctrl_abc123"}

{"request_id": "ctrl_def456", "approved": true}

{"approved": true, "request_id": "ctrl_def456"}

{"task": "Find CTOs at fintech startups in Berlin", "attempts": 3}

{"id": "job_abc123", "status": "queued", "task": "...", "attempts": 3, "max_attempts": 3, "output_dir": "./jobs/job_abc123", "log": "./jobs/job_abc123/run.log"}

{"jobs": [...], "count": 5}

{"id": "job_abc123", "status": "completed", "task": "...", "attempts": 1, "max_attempts": 3}

{"id": "job_abc123", "status": "cancelled"}

?lines=100  (default 100, cap 2000)

{"lines": ["...", "..."], "total_lines": 150, "returned": 100}

{"id": "job_abc123", "status": "queued", ...}

?q=CTO+fintech&scope=agent&status=active&limit=20&top_k=10

{"query": "CTO fintech", "memories": [...]}

{"facts": [{"content": "Acme Corp uses React", "confidence": 0.9}], "source": "research", "scope": "agent"}

{"created": 1, "duplicates": 0, "superseded": 0}

{"embedding_model": "text-embedding-3-small", "scopes": {"agent": {"active": 42, "superseded": 5, "archived": 12}}, "entity_graph": {"nodes": 28, "edges": 45}}

?session=sess_abc123&dry_run=true

{"promoted": 8, "archived": 3}

?ttl_days=30&dry_run=false

{"stale_archived": 15, "compacted": 2, "dry_run": false}

?follow=latest  (options: active, latest, full_history)

{"memories": [...]}

{"archived": "mem_abc123"}

{
"status": "ok",
"service": "fathom",
"version": "0.3.0",
"database": "ok",
"active_sessions": 2
}

// Possible values:
// status: "ok" | "degraded"
// database: "ok" | "error"

# HELP pr_sessions_total Total number of sessions
# TYPE pr_sessions_total counter
pr_sessions_total 42

# HELP pr_agents_active Currently active agents
# TYPE pr_agents_active gauge
pr_agents_active 3

# HELP pr_request_duration_seconds Request latency
# TYPE pr_request_duration_seconds histogram
pr_request_duration_seconds_bucket{le="0.1"} 120