Skip to content
Sphere · Docs

Sphere Graph API — Introduction

The Graph API is the trust graph as a service. It owns the canonical representation of who-trusts-whom, who-is-in-what-group, and the audit log of every change.

Phase 1 scope (~1–2 weeks of work):

  • A REST service in its own pod (or container, on aetherius-2).
  • UUID-keyed entities; identities link to platform IDs (Telegram, tenant…).
  • Authenticated, audited mutations.
  • A graph-traversal /query endpoint for ego-network and sphere queries.

See the Phase 1 plan for the full design doc (link will resolve once the repo is public; for now it’s at ~/.openclaw/shared/projects/sphere/plans/SHORT-TERM-PLAN-PHASE-1.md).

Status: design done, implementation not started. This page is a stub that will fill out as the service comes up.