Conversation history

GET /api/chat/messages returns a page of messages, oldest first. It is the read path for chat content.

curl "https://client-api.lala.ist/api/chat/messages?limit=50" \
  -H "Authorization: Bearer $LALA_TOKEN"

{
  "messages": [
    {
      "id": "6f3c1e0a-1b2c-4d5e-8f90-1a2b3c4d5e6f",
      "role": "user",
      "content": "Bugün 4 saat çalıştım",
      "media": [],
      "reactions": [],
      "replyTo": null,
      "turnIndex": 0,
      "cursor": "czoxMjM0",
      "timestamp": "2026-08-01T18:03:11.000Z"
    },
    {
      "id": "9a8b7c6d-5e4f-4a3b-9c8d-7e6f5a4b3c2d",
      "role": "lala",
      "content": "Güzel. Hangi derse ne kadar verdin?",
      "media": [],
      "reactions": [{ "emoji": "🔥", "actor": "lala", "createdAt": "2026-08-01T18:03:20.000Z" }],
      "replyTo": null,
      "turnIndex": 0,
      "cursor": "czoxMjM1",
      "timestamp": "2026-08-01T18:03:19.000Z"
    }
  ],
  "nextCursor": "czoxMjM0",
  "hasMore": true
}

Paging

Paging is by cursor. Each message carries an opaque cursor, and each page carries a nextCursor that points at the page before it.

Open the chat with no parameters. The response is the newest page.
To load older messages, send nextCursor as the before parameter.
Repeat until hasMore is false.

curl "https://client-api.lala.ist/api/chat/messages?limit=50&before=czoxMjM0" \
  -H "Authorization: Bearer $LALA_TOKEN"

limit is 50 by default and 100 at most.

The cursor is opaque. Do not parse it, and do not build one. Its format can change. Send back only a value the API gave you.

Catch up after a lost connection

The after parameter reads forward instead of backward. Send the cursor of your newest message to get everything that arrived since. Use it after the realtime stream closes. Read Realtime updates.

curl "https://client-api.lala.ist/api/chat/messages?after=czoxMjM1" \
  -H "Authorization: Bearer $LALA_TOKEN"

Message fields

Field	Type	Notes
`id`	uuid	Stable. Key the UI on it and merge by it.
`role`	`user` or `lala`	Lala’s role is `lala`. There is no `assistant` role.
`content`	string	Turkish text. Empty when the message is media only.
`media`	array	Attachments. Empty for a text message. Read Media.
`reactions`	array	Each entry has `emoji`, `actor`, and `createdAt`.
`replyTo`	object or null	The message this one answers. Holds `id`, `role`, a 200-character `content` quote, and `mediaKind`.
`turnIndex`	integer	Position inside one Lala turn. Read Chat streaming.
`cursor`	string	Opaque. Send as `before` or `after`.
`timestamp`	date-time	UTC, ISO 8601. Convert to Europe/Istanbul for display.

What the model sees

The model reads the last 60 messages plus rolling summaries of what came before. This window is independent of your paging: the student can scroll back through the whole conversation, and the window stays at 60.

When to call it

Call the endpoint at these four moments:

When the chat screen opens.
When the application returns to the foreground.
When the student scrolls to the top of the loaded messages, with before.
After the realtime stream closes, with after.

Do not poll. Read Realtime updates.

Local state

Every message has a stable id. Merge the server response into the local list by id, and replace an optimistic local copy when the real message arrives.

Start here

Build

Understand

For agents

Paging

Catch up after a lost connection

Message fields

What the model sees

When to call it

Local state

​Paging

​Catch up after a lost connection

​Message fields

​What the model sees

​When to call it

​Local state

Paging

Catch up after a lost connection

Message fields

What the model sees

When to call it

Local state