Documentation

Read the source code of your memory.

Docs / rest-api / sun-and-admin

Sun & Admin

Endpoints for steering document management and admin operations.

Sun (Steering Document)

GET /sun

Get all Sun sections.

GET /sun/{section_key}

Get a specific section. Keys: identity, values, agent_protocol, planet_registry, working_context, evolution_log, steering_doc.

PUT /sun/{section_key}

Update a section. Body: {"content": {...}, "changed_by": "user", "summary": "Updated values"}.

GET /sun/evolution-log

Get the change history.

POST /sun/working-context/add-blocker

Add a blocker. Body: {"blocker": "Waiting on API key from vendor"}.

POST /sun/working-context/add-decision

Add a decision. Body: {"decision": "Use Redis for session storage", "biome": "Auth Refactor"}.

POST /sun/steering-doc/reimport

Re-read the steering document from its originally stored file path. Only works if the steering doc was imported from a file during onboarding.

Admin (Owner/Admin Only)

GET /admin/agents/active

Active agents in the last 24 hours.

GET /admin/planets/health

Health scores for all planets.

GET /admin/contradictions/summary

Contradiction counts by status and region.

GET /admin/bridges/activity

Cross-planet relationship activity this week.

GET /admin/sessions/daily

Daily session counts grouped by agent.

curl "http://localhost:8000/api/v1/admin/sessions/daily?days=30"

GET /admin/strength/history

Galaxy strength trend over time.

curl "http://localhost:8000/api/v1/admin/strength/history?days=90"