API Reference

List discovered primes with pagination and filtering.

{
  "primes": [
    {
      "id": 1,
      "form": "factorial",
      "expression": "147855! + 1",
      "digits": 636919,
      "proof_type": "pocklington",
      "certificate": { ... },
      "discovered_at": "2026-02-14T12:00:00Z"
    }
  ],
  "total": 2847,
  "page": 1,
  "per_page": 50
}

Get a single prime with full certificate data.

Aggregate statistics: total primes, candidates tested, active workers.

{
  "total_primes": 2847,
  "candidates_tested": 14200000000,
  "active_workers": 38,
  "compute_hours": 127000,
  "search_forms": 12
}

Re-verify a prime through the 3-tier pipeline. Returns updated proof status.

{
  "prime_id": 42,
  "result": "verified",
  "proof_type": "pocklington",
  "certificate": { ... }
}

List all registered workers with status and last heartbeat.

Register a new worker with the coordinator.

Worker heartbeat with progress and status update.

Fleet overview: all nodes, active searches, aggregate stats.

List operators with node counts, compute hours, and prime counts.

{
  "operators": [
    {
      "id": "op-abc",
      "name": "alice",
      "contact_email": "alice@example.com",
      "node_count": 4,
      "total_compute_hours": 1200,
      "primes_found": 23
    }
  ]
}

Register a new operator account.

List all nodes across all operators with status.

Register a new node under an operator.

Node heartbeat with system metrics and progress.

List search jobs with status (running, completed, paused).

Create a new search job.

Claim the next available work block (FOR UPDATE SKIP LOCKED).

Mark a work block as completed with results.

List active searches with progress and rate metrics.

Start a new search with form and range parameters.

List agent tasks with status and assigned agent.

{
  "tasks": [
    {
      "id": "task-123",
      "title": "Optimize factorial sieve depth",
      "status": "running",
      "agent": "strategy-agent",
      "created_at": "2026-02-20T10:00:00Z"
    }
  ]
}

Create a new agent task.

Update task status or assignment.

Get agent compute budgets and spend tracking.

Set or update an agent budget.

Read agent memory key-value store.

Write to agent memory.

List agent automation schedules.

Create or update a schedule.

List all projects with phase status and progress.

Create a new project campaign.

Get project details with phases, events, and cost breakdown.

Update project configuration or budget.

Manually advance to the next phase.

System metrics: CPU, memory, disk, and worker rates.

Recent system logs with filtering and pagination.

Time-series data for performance charts.

Get latest worker release metadata for a channel.

{
  "channel": "stable",
  "version": "0.1.0",
  "published_at": "2026-02-20T00:00:00Z",
  "notes": "Initial public release",
  "artifacts": [
    {
      "os": "linux",
      "arch": "x86_64",
      "url": "https://downloads.darkreach.ai/...",
      "sha256": "..."
    }
  ]
}

Upsert a worker release record.

Set channel target version and rollout percentage.

Rollback a channel to the previous version.

Audit trail of rollout and rollback events.

Release adoption summary by worker version.

List all documentation files with titles and categories.

Get a documentation file by slug.

Multi-word search across all docs with relevance ranking.

{
  "results": [
    {
      "slug": "sophie-germain",
      "title": "Sophie Germain Primes",
      "snippets": [
        { "text": "...matching line...", "line": 42 }
      ],
      "category": "roadmaps",
      "score": 35
    }
  ]
}

Get a roadmap document.

Get a CLAUDE.md agent file.

List notification subscriptions.

Subscribe to push notifications for prime discoveries.

Health check and readiness probe.

Coordinator status with uptime, version, and worker count.

{
  "status": "healthy",
  "version": "0.1.0",
  "uptime_seconds": 86400,
  "database": "connected",
  "workers_online": 38,
  "active_searches": 5,
  "ai_engine": "running"
}