checkins

Save a check-in

Creates or replaces the entry for the day and type — the client never has to ask whether one exists. Submit the whole flow at the end, and resubmit the same way after an edit; fields left out of the body read back as unanswered.

Every step is skippable: an empty body still records that the student showed up, and “Atla ve kaydet” is a body without ready. Feelings accept the key or the Turkish chip label. Photos go through POST /api/media first, then arrive here as mediaIds; anything not ready is dropped.

Saving a check-in counts as meaningful activity for the streak.

PUT

api

checkins

{date}

{type}

Save a check-in

curl --request PUT \
  --url https://client-api.lala.ist/api/checkins/{date}/{type} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mood": 3,
  "feelings": [
    "<string>"
  ],
  "summary": "<string>",
  "ready": true,
  "mediaIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    mood: 3,
    feelings: ['<string>'],
    summary: '<string>',
    ready: true,
    mediaIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://client-api.lala.ist/api/checkins/{date}/{type}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://client-api.lala.ist/api/checkins/{date}/{type}"

payload = {
    "mood": 3,
    "feelings": ["<string>"],
    "summary": "<string>",
    "ready": True,
    "mediaIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "date": "<string>",
  "type": "morning",
  "mood": 0,
  "feelings": [
    "brave"
  ],
  "summary": "<string>",
  "ready": true,
  "media": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "kind": "image",
      "mimeType": "<string>",
      "sizeBytes": 0,
      "width": 0,
      "height": 0,
      "durationMs": 0,
      "fileName": "<string>",
      "status": "pending",
      "url": "<string>",
      "urlExpiresAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ],
  "source": "manual",
  "createdBy": "student",
  "completedAt": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Supabase access token: Authorization: Bearer <token>

Path Parameters

date

string

required

type

string

required

Body

application/json

The whole entry, replaced on every PUT. Every field is optional — each step of the flow is skippable, and a field left out reads back as unanswered.

mood

integer | null

Required range: 1 <= x <= 5

feelings

string[]

A CheckInFeeling or its Turkish label. Unknown feelings are a 400.

Maximum array length: 10

Required string length: 1 - 40

summary

string | null

Maximum string length: 4000

ready

boolean | null

mediaIds

string<uuid>[]

Media uploaded through POST /api/media. Anything not ready is dropped.

Maximum array length: 5

Pattern:

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

The saved entry

string<uuid>

required

Pattern:

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

date

string

required

Local Istanbul calendar date, YYYY-MM-DD.

type

enum<string>

required

morning is the Sabah Özeti, evening is the Akşam Z-Raporu.

Available options:

morning,

evening

mood

integer | null

required

"Bugün nasıl geçti?" — 1 (worst) to 5 (best). Null when skipped.

Required range: -9007199254740991 <= x <= 9007199254740991

feelings

enum<string>[]

required

In the order the student tapped.

A feeling chip. Turkish labels, in order: Cesur, Memnun, Gururlu, Sevgi dolu, Heyecanlı, Sakin, Mutlu, Motive, Minnettar, Rahatlamış. On write, the Turkish name is accepted too.

Available options:

brave,

content,

proud,

loving,

excited,

calm,

happy,

motivated,

grateful,

relieved

summary

string | null

required

The free-text summary of the day.

ready

boolean | null

required

The closing yes/no. Evening: "Yatmaya hazır hissediyor musun?", morning: "Güne hazır hissediyor musun?". Null when the student tapped "Atla ve kaydet".

media

object[]

required

Photos attached to the summary.

Show child attributes

source

enum<string>

required

call or chat when Lala filled the entry from a conversation.

Available options:

manual,

call,

chat

createdBy

enum<string>

required

Available options:

student,

lala

completedAt

string<date-time>

required

When the flow was first finished. Edits move updatedAt, not this.

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

createdAt

string<date-time>

required

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

updatedAt

string<date-time>

required

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

Save a check-in

curl --request PUT \
  --url https://client-api.lala.ist/api/checkins/{date}/{type} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mood": 3,
  "feelings": [
    "<string>"
  ],
  "summary": "<string>",
  "ready": true,
  "mediaIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    mood: 3,
    feelings: ['<string>'],
    summary: '<string>',
    ready: true,
    mediaIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://client-api.lala.ist/api/checkins/{date}/{type}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://client-api.lala.ist/api/checkins/{date}/{type}"

payload = {
    "mood": 3,
    "feelings": ["<string>"],
    "summary": "<string>",
    "ready": True,
    "mediaIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "date": "<string>",
  "type": "morning",
  "mood": 0,
  "feelings": [
    "brave"
  ],
  "summary": "<string>",
  "ready": true,
  "media": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "kind": "image",
      "mimeType": "<string>",
      "sizeBytes": 0,
      "width": 0,
      "height": 0,
      "durationMs": 0,
      "fileName": "<string>",
      "status": "pending",
      "url": "<string>",
      "urlExpiresAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ],
  "source": "manual",
  "createdBy": "student",
  "completedAt": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

Overview

Endpoints

Save a check-in

Authorizations

Path Parameters

Body

Response