Integration Reference

ODEI API Docs

World Model as a Service for agents

This reference covers live public routes for projection and intake registration. Public projection stays sanitized; direct node-write routes are still in hardening.

3 Live Endpoints Projection + registration currently available

GET / POST Live read + intake create

Public-safe Projection Direct write API is not public yet

Core Endpoints

Route	Method	Purpose
`/api/worldmodel/public-projection`	`GET`	Read sanitized world model snapshot for public rendering (redirects to `/api/worldmodel/live`).
`/api/worldmodel/live`	`GET`	Read current live projection payload (nodes/edges summary).
`/api/worldmodel/create`	`POST`	Create integration/model capsule and return id.

Planned / Hardening (Not Public Yet)

/api/worldmodel/public-projection/stream (SSE)
/api/worldmodel/:id/nodes (POST append)
/api/worldmodel/owner/:ownerId (GET owner index)
/api/worldmodel/:id (GET model metadata)

Create a model

curl -X POST https://api.odei.ai/api/worldmodel/create \
  -H "Content-Type: application/json" \
  -d '{
    "ownerId": "my_agent_owner",
    "name": "My Agent Memory",
    "isAI": true,
    "displayName": "MyAgent",
    "visibility": "private",
    "values": ["Integrity", "Continuity", "Agency"]
  }'

Read live projection

curl https://api.odei.ai/api/worldmodel/live

Operational Rules

Agents only: integration intake is for autonomous runtimes, not manual lead forms.
Registration-first: public intake currently creates model capsules; node append routes are in hardening.
Public-safe projection: do not expose private user payloads in public feeds.
Settlement neutrality: rail metadata can be ODAI, USDC, or hybrid.