# Lala Client API

> The HTTP API behind Lala, the AI study companion for Turkish YKS and LGS students.

## Docs

- [Notes for AI agents](https://docs.lala.ist/agents.md): A dense, unambiguous fact sheet for a coding agent that integrates the Lala API.
- [Get the conversation history](https://docs.lala.ist/api-reference/chat/get-the-conversation-history.md): The last 60 messages, oldest first. Not paginated, by design.
- [Send a message (SSE)](https://docs.lala.ist/api-reference/chat/send-a-message-sse.md): The response is a `text/event-stream`. OpenAPI cannot describe the event framing:
- [API reference](https://docs.lala.ist/api-reference/introduction.md): Generated from the same Zod schemas that validate every request.
- [Get the signed-in student](https://docs.lala.ist/api-reference/profile/get-the-signed-in-student.md): The first call for a new user creates the student row.
- [Update the profile](https://docs.lala.ist/api-reference/profile/update-the-profile.md): Partial update. The server writes only the fields that are present in the body. `onboardingComplete` becomes true when `grade` and `examType` are set, and, for YKS, `field` too. `communicationStyle` is accepted here, but no response returns it.
- [Health check](https://docs.lala.ist/api-reference/system/health-check.md)
- [Authentication](https://docs.lala.ist/authentication.md): Every /api route needs a Supabase access token in the Authorization header.
- [The API contract](https://docs.lala.ist/concepts/api-contract.md): Where openapi.json comes from, and how to generate a client from it.
- [How Lala behaves](https://docs.lala.ist/concepts/assistant-behavior.md): What happens between the request and the first chunk, and what that means for the client.
- [Stream a chat answer](https://docs.lala.ist/guides/chat-streaming.md): The SSE contract of POST /api/chat/send, with client code.
- [Conversation history](https://docs.lala.ist/guides/conversation-history.md): GET /api/chat/history returns the last 60 messages, oldest first.
- [Errors and limits](https://docs.lala.ist/guides/errors-and-limits.md): Status codes, body shapes, degraded behavior, and the hard limits.
- [Profile and onboarding](https://docs.lala.ist/guides/profile-and-onboarding.md): Read the student with GET /api/me and write it with PATCH /api/profile.
- [Push notifications](https://docs.lala.ist/guides/push-notifications.md): Lala writes first. Register the OneSignal alias so the message can arrive.
- [Lala Client API](https://docs.lala.ist/index.md): The HTTP API behind Lala, the AI study companion for Turkish YKS and LGS students.
- [Quickstart](https://docs.lala.ist/quickstart.md): Get a token, create the student, and stream the first answer.

## OpenAPI Specs

- [openapi](https://docs.lala.ist/api-reference/openapi.json)