Messages / Blocks
Chat- und Nachrichten-Inhalte in Liza sind „Blocks". Für einfaches Nachrichten-Posten gibt es zusätzlich einen bequemen Endpunkt.
Nachricht posten (einfach)
| Methode | Pfad | Zweck |
|---|---|---|
POST | /v1/messages | Chat-Nachricht in eine Liste oder ein Item posten |
Body: { "list": "<listId>" } oder { "list_item": "<itemId>" } plus text.
bash
curl -X POST https://api.eu.liza.app/api/v1/messages \
-H "Authorization: Bearer DEIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"list_item":"ITEM_ID","text":"Erledigt ✅"}'Blocks (fortgeschritten)
Basis-Pfad: /v1/blocks. Feingranulare Kontrolle über Chat-/Thread-Inhalte.
| Methode | Pfad | Zweck |
|---|---|---|
POST | /v1/blocks | Block/Nachricht anlegen |
GET | /v1/blocks/{blockId} | Block abrufen (UUID oder SID) |
POST | /v1/blocks/feed | Blocks eines Kontexts laden (Channel/Thread/Item) |
POST | /v1/blocks/load | Ältere Blocks (Cursor) |
POST | /v1/blocks/next | Neuere Blocks |
PATCH | /v1/blocks/{blockId} | Block ändern (nur Ersteller) |
DELETE | /v1/blocks/{blockId} | Block löschen (nur Ersteller) |
POST | /v1/blocks/{blockId}/reactions | Emoji-Reaktion umschalten |
Body — Block anlegen (POST /v1/blocks)
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
type | string (≤100) | ✅ | Block-Typ (z. B. Chat) |
group_ | UUID | ✅ | Gruppe/Channel-Kontext |
text | string | – | Text (Default "") |
content | object | array | – | strukturierter Inhalt |
list / list_item / channel / thread / parent / call | UUID | – | Kontext-Bezug |
mentions | UUID[] | – | Erwähnungen |
tags | string[] | – | Tags |
scope | enum public|inherit|private | – | Sichtbarkeit (Default inherit) |
color | #RRGGBB | – | Farbe |
start_date / end_date | date (ISO) | – | Zeitraum |
askAI | boolean | – | KI-Antwort anfordern (Default false) |
reactions erwartet { emoji, group_ }. Reine Ansichts-Endpunkte (feed/load/next) nehmen Kontext-IDs + size.
TIP
Für einfaches „Kommentar an ein Item hängen" reicht POST /v1/messages bzw. im MCP das Tool post_chat_message. Die /v1/blocks-Endpunkte sind für Clients, die ganze Chat-Feeds rendern.