Lists
Basis-Pfad: /v1/lists · Auth: Bearer
| Methode | Pfad | Zweck |
|---|---|---|
GET | /v1/lists | Listen auflisten (Pagination/Filter) |
POST | /v1/lists | Liste anlegen |
GET | /v1/lists/{listId} | Liste inkl. Items abrufen |
PATCH | /v1/lists/{listId} | Liste ändern |
DELETE | /v1/lists/{listId} | Liste löschen (Soft-Delete) |
{listId} akzeptiert UUID oder SID.
Query (GET /v1/lists)
Pagination (page, pageSize, search) plus:
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
status | enum open|inprogress|done|completed|closed|archived | – | nach Status |
lifecycle | enum active|archived|trashed | – | nach Lifecycle |
parent | UUID | null | – | untergeordnete Listen |
includeTemplates | boolean | false | Vorlagen einschließen |
excludeCompleted | boolean | false | abgeschlossene ausblenden |
Query (GET /v1/lists/{listId})
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
includeItems | boolean | true | Items mitliefern |
includeArchived | boolean | false | Archivierte Items einschließen |
Body — anlegen (POST /v1/lists)
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
name | string (1–255) | ✅ | Name |
description | string | – | Beschreibung |
type | string | – | Typ |
status | enum (s. o.) | – | Initialer Status |
parent | UUID | null | – | übergeordnete Liste |
members | UUID[] | – | Mitglieder |
owners | UUID[] | – | Owner |
tags | string[] | – | Tags |
color | string | – | Farbe |
cover | string | – | Cover |
start_ts / end_ts | date (ISO) | – | Zeitraum |
all_day | boolean | – | ganztägig |
Body — ändern (PATCH /v1/lists/{listId})
Wie beim Anlegen (alle optional), zusätzlich lifecycle (active/archived/trashed) und locked (boolean).
Beispiel
bash
curl -X POST https://api.eu.liza.app/api/v1/lists \
-H "Authorization: Bearer DEIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Sprint 42","description":"Backlog"}'