List Items

Two equivalent entry points: the flat resource /v1/list-items and the nested path under a specific list.

Method	Path	Purpose
GET	/v1/list-items	List items (pagination/filters)
POST	/v1/list-items	Create item
GET	/v1/list-items/{itemId}	Fetch item
PATCH	/v1/list-items/{itemId}	Update item
DELETE	/v1/list-items/{itemId}	Delete item (soft delete)
GET	/v1/lists/{listId}/items	Items of a list
POST	/v1/lists/{listId}/items	Create item in a list

Query (GET /v1/list-items)

Pagination (page, pageSize, search) plus:

Parameter	Type	Description
list	UUID	by list
status	string	exact status
priority	number (1–10)	by priority
assigned_to	UUID	by assigned user
includeArchived	boolean (default false)	include archived
includeTrashed	boolean (default false)	include trash

REST vs. MCP

The convenience filters state, assigned_to_me, due_within_days, sort, and compact are only available on the MCP toollist_list_items — not in the REST API.

Body — create (POST /v1/list-items or /v1/lists/{listId}/items)

Field	Type	Required	Description
list	UUID	✅*	Target list (*omitted on the nested path)
text	string (1–500)	✅	Title
description	string	–	Description
status	string	–	Status (see below)
stage	string	–	Workflow stage
progress	number (0–100)	–	Progress
priority	number (1–10)	–	Priority
type	string	–	Type
scope	enum public|private|shared	–	Visibility
assigned_to	UUID[]	–	Assignments
responsible	UUID | null	–	Responsible person
tags	string[]	–	Tags
target_date / start_date / end_date	date (ISO) | null	–	Dates
time_allocated	number ≥ 0	–	Time budget
fields	object	–	Custom fields
parent	UUID | null	–	Parent item
sort_key	string	–	Sort key
num / level	integer	–	Numbering / level

Body — update (PATCH /v1/list-items/{itemId})

Same as create (all optional, without list), plus archived (boolean).

Status: open = ""/todo/open/in_progress; done = done/completed.

Example

# Open items of a list
curl "https://api.eu.liza.app/api/v1/lists/LIST_ID/items?includeArchived=false" \
  -H "Authorization: Bearer DEIN_TOKEN"

# Create an item
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"}'