Developer API

State-aware trajectory infrastructure — Atlas coordinates, collective pulse, and gated quotas. Not a generic LLM passthrough.

Already registered? Open your key dashboard to rotate, revoke, or inspect usage.

Manage your API keys →

Endpoints

GET /api/trajectory/collective-pulse — Anonymous mood distribution (no identities).
GET /api/trajectory/user-arc — Signed-in user arc — self only today.
GET /api/mood/discovery-feed — Discovery-safe cards for widgets and embeds.
POST /api/developer/register — Creates an API key (requires session).
GET /api/council/world-signals — Latest Council world-ingest rows (derivative summaries + source links; rate-limited).

Partner API (`/api/v1`)

Authenticated integrators use a bearer API key. Each call can debit Essence from the key owner (defaults below, or `ApiKey.essencePerCall` when set). Responses are for philosophical / product use with your own disclaimer.

`POST /api/v1/oracle` — Oracle completion (default 15 Essence per call).
`POST /api/v1/mood/analyze` — mood-oriented analysis (default 5).
`GET`/`POST /api/v1/user/memory` — scoped memory bridge (default 10).
`GET`/`POST`/`DELETE /api/v1/keys` — manage keys (session; creation returns raw key once).
`GET /api/v1/collective` — collective snapshot for widgets.
`GET /api/v1/atlas/moods` — Atlas mood catalog metadata.

Pricing model

Essence: optional per-call billing via ApiKey.essencePerCall (in-app unit, not legal tender).

Membership tiers map to daily quotas on trajectory routes — see api-gate.

Example curl

Collective pulse (no auth):

curl -sS "http://essentiamemoria.com/api/trajectory/collective-pulse"

User arc (session cookie or future bearer on contracted flows):

curl -sS "http://essentiamemoria.com/api/trajectory/user-arc" -H "Cookie: your_session=…"

Spawn 3D Objects via Webhook

POST a payload to /api/v1/world/spawn with your API key to instantly materialize objects inside the Essentia cosmos. Requires a key with write or * scope.

Object types

billboard — large visual anchor visible across layers
event — time-bounded node with countdown
notification — transient message orb (default)
content_node — persistent knowledge artifact

Example — CI success beacon

curl -sS -X POST "http://essentiamemoria.com/api/v1/world/spawn" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "event",
  "title": "Product Launch",
  "description": "Our new feature is live!",
  "moodTarget": "7",
  "layerTarget": 3,
  "durationHours": 48
}'

Response

{
  "ok": true,
  "objectId": "cm...",
  "type": "event",
  "title": "Product Launch",
  "expiresAt": "2026-05-16T12:00:00.000Z",
  "position": "cosmos_event_node",
  "moodTarget": "7",
  "layerTarget": 3
}

Use cases

GitHub CI passes → spawn a success beacon in the cosmos
Customer signs up → spawn a celebration node for your team
Calendar event starts → spawn a countdown orb
Zapier / Make trigger → materialise any real-world signal as a 3D object

Register a key

Outputs are for philosophical exploration only; downstream products must show an equivalent disclaimer to end users.

You must be signed in. Keys are stored on your account.

Key label

This system's emotional analyses and trajectory data are for philosophical exploration; they are not medical, psychological, or professional advice. In a crisis, contact a qualified professional.

Administrators: the complete partner API documentation page lists `/api/v1/…` routes (requires an admin session).

← Core