Sessions - Wu-Weism

Two endpoints manage causal chat sessions: one to list all sessions associated with your account, and one to retrieve the full message history for a specific session.

List sessions

GET /api/causal-chat/sessions

Returns all sessions belonging to the authenticated user, ordered by most recently updated.

Authentication

Required. Include a session cookie or Authorization: Bearer <token> header.

Response

Status: 200 OK
Content-Type: application/json

sessions

object[]

required

Array of session summary objects.

Hide session properties

string

required

UUID uniquely identifying the session. Use this value as sessionId when sending messages or fetching session messages.

title

string

required

Human-readable title derived from the first question in the session.

updated_at

string

required

ISO 8601 timestamp of the most recent activity in the session.

domain_classified

string

required

Primary domain label assigned during the session’s first causal analysis, e.g. "neuroscience". May be null if classification has not yet completed.

Example

curl --request GET \
  --url https://wuweism.com/api/causal-chat/sessions \
  --header 'Authorization: Bearer <token>'

const response = await fetch('https://wuweism.com/api/causal-chat/sessions', {
  headers: {
    'Authorization': 'Bearer <token>',
  },
});
const { sessions } = await response.json();

200

{
  "sessions": [
    {
      "id": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
      "title": "Does cortisol exposure causally increase hippocampal volume reduction?",
      "updated_at": "2026-04-05T14:32:00Z",
      "domain_classified": "neuroscience"
    },
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "title": "What is the causal effect of sleep deprivation on reaction time?",
      "updated_at": "2026-04-04T09:15:00Z",
      "domain_classified": "cognitive_science"
    }
  ]
}

Get session messages

GET /api/causal-chat/sessions/{sessionId}

Returns the full ordered message history for a specific session.

Authentication

Required. Include a session cookie or Authorization: Bearer <token> header.

Path parameters

sessionId

string

required

UUID of the session to retrieve. Obtain this from the id field in the list sessions response.

Response

Status: 200 OK
Content-Type: application/json

messages

object[]

required

Chronologically ordered array of messages in the session.

Hide message properties

string

required

UUID uniquely identifying this message.

role

string

required

Speaker role: "user" or "assistant".

content

string

required

Full text content of the message.

created_at

string

required

ISO 8601 timestamp when the message was created.

causal_graph

object

Causal graph snapshot attached to this message, if any. Present on "assistant" messages that include a rendered SCM. The structure mirrors the tier-1/tier-2 schema returned in the scm_loaded SSE event. May be null.

Example

curl --request GET \
  --url https://wuweism.com/api/causal-chat/sessions/3f2504e0-4f89-11d3-9a0c-0305e82c3301 \
  --header 'Authorization: Bearer <token>'

const sessionId = '3f2504e0-4f89-11d3-9a0c-0305e82c3301';
const response = await fetch(
  `https://wuweism.com/api/causal-chat/sessions/${sessionId}`,
  {
    headers: {
      'Authorization': 'Bearer <token>',
    },
  }
);
const { messages } = await response.json();

200

{
  "messages": [
    {
      "id": "a1b2c3d4-0000-0000-0000-000000000001",
      "role": "user",
      "content": "Does cortisol exposure causally increase hippocampal volume reduction?",
      "created_at": "2026-04-05T14:31:45Z",
      "causal_graph": null
    },
    {
      "id": "a1b2c3d4-0000-0000-0000-000000000002",
      "role": "assistant",
      "content": "Yes. The causal pathway from elevated cortisol to hippocampal volume reduction is well-supported by the loaded SCM...",
      "created_at": "2026-04-05T14:32:00Z",
      "causal_graph": {
        "modelKey": "neuroscience_hpa_axis",
        "version": "2.1.0",
        "tier1": {},
        "tier2": {}
      }
    }
  ]
}

Error responses

Status	Description
`401`	Missing or invalid authentication credentials.
`404`	No session found with the given `sessionId` for the authenticated user.

​List sessions

​Authentication

​Response

​Example

​Get session messages

​Authentication

​Path parameters

​Response

​Example

​Error responses

List sessions

Authentication

Response

Example

Get session messages

Authentication

Path parameters

Response

Example

Error responses