Skip to main content
Lala is an AI study companion for students who prepare for the Turkish YKS and LGS exams. This API is the interface between a client application and Lala. It is a plain HTTP and JSON service, so any client can use it. The API does five things:
  • It authenticates a student with a Supabase access token.
  • It creates and updates the student profile.
  • It streams a chat answer over Server-Sent Events (SSE).
  • It returns the recent conversation history.
  • It reports service health.

Base URL

https://client-api.lala.ist

​
Endpoints

Every path under /api needs a Supabase access token. Read Authentication.

​
Start here

Quickstart

Get a token and stream your first answer.

Authentication

How the server verifies a Supabase token.

Stream a chat answer

The SSE event contract, with client code.

Notes for AI agents

A dense fact sheet for a coding agent.

​
What the API does not do

The API is small on purpose. These items are out of scope for version 1:
  • No pagination. The history endpoint returns a fixed window of 60 messages.
  • No WebSocket transport. The only stream is the SSE response of POST /api/chat/send.
  • No message identifiers for outgoing messages. The client cannot edit or delete a message.
  • No file upload endpoint. An image goes inline in the chat request body as base64.
  • No admin surface, no voice, and no WhatsApp or Telegram transport.

​
Language

The API is bilingual by design:
  • All content that a student reads is Turkish. The chat text is Turkish.
  • Everything a developer reads is English. Field names, event names, error strings, and the whole OpenAPI document are English.
An error body is always the same shape, and the error value is a short English string: