List Items
Zwei gleichwertige Zugänge: die flache Ressource /v1/list-items und der verschachtelte Pfad unter einer Liste.
| Methode | Pfad | Zweck |
|---|---|---|
GET | /v1/list-items | Items auflisten (Pagination/Filter) |
POST | /v1/list-items | Item anlegen |
GET | /v1/list-items/{itemId} | Item abrufen |
PATCH | /v1/list-items/{itemId} | Item ändern |
DELETE | /v1/list-items/{itemId} | Item löschen (Soft-Delete) |
GET | /v1/lists/{listId}/items | Items einer Liste |
POST | /v1/lists/{listId}/items | Item in Liste anlegen |
Query (GET /v1/list-items)
Pagination (page, pageSize, search) plus:
| Parameter | Typ | Beschreibung |
|---|---|---|
list | UUID | nach Liste |
status | string | exakter Status |
priority | number (1–10) | nach Priorität |
assigned_to | UUID | nach zugewiesenem User |
includeArchived | boolean (default false) | archivierte einschließen |
includeTrashed | boolean (default false) | Papierkorb einschließen |
REST vs. MCP
Die komfortablen Filter state, assigned_to_me, due_within_days, sort, compact gibt es nur beim MCP-Toollist_list_items — nicht in der REST-API.
Body — anlegen (POST /v1/list-items oder /v1/lists/{listId}/items)
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
list | UUID | ✅* | Ziel-Liste (*entfällt beim verschachtelten Pfad) |
text | string (1–500) | ✅ | Titel |
description | string | – | Beschreibung |
status | string | – | Status (s. u.) |
stage | string | – | Workflow-Stufe |
progress | number (0–100) | – | Fortschritt |
priority | number (1–10) | – | Priorität |
type | string | – | Typ |
scope | enum public|private|shared | – | Sichtbarkeit |
assigned_to | UUID[] | – | Zuweisungen |
responsible | UUID | null | – | Verantwortlich |
tags | string[] | – | Tags |
target_date / start_date / end_date | date (ISO) | null | – | Termine |
time_allocated | number ≥ 0 | – | Zeitbudget |
fields | object | – | Custom Fields |
parent | UUID | null | – | Übergeordnetes Item |
sort_key | string | – | Sortierschlüssel |
num / level | integer | – | Nummerierung / Ebene |
Body — ändern (PATCH /v1/list-items/{itemId})
Wie beim Anlegen (alle optional, ohne list), zusätzlich archived (boolean).
Status: offen = ""/todo/open/in_progress; erledigt = done/completed.
Beispiel
bash
# Offene Items einer Liste
curl "https://api.eu.liza.app/api/v1/lists/LIST_ID/items?includeArchived=false" \
-H "Authorization: Bearer DEIN_TOKEN"
# Item anlegen
curl -X POST https://api.eu.liza.app/api/v1/lists/LIST_ID/items \
-H "Authorization: Bearer DEIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"text":"Release vorbereiten","priority":7,"target_date":"2026-07-10"}'