API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · task_lists

Task List Schema

Schema-ID
task_list
Collection
task_lists
Permissions
  • Lesentask_list_view
  • Anlegentask_list_create
  • Änderntask_list_edit
  • Löschentask_list_delete

Felder

Task List Schema

task_lists4 Permissions

Personal or team-scoped bucket for tasks (Todoist-style, ADR 0132)

namestringerforderlich

List title shown in sidebar and headers

1–80 Zeichen
descriptionstringoptional

Optional description shown in list header

max 500 Zeichennullable
colorstringerforderlich

Theme token key for accent color

Werte
accentinfowarningdangermutedprimarysuccess
iconNamestringerforderlich

Key from Icons.tsx — must exist in the Icons registry

1–60 Zeichen
parentListIduuidoptional

Optional parent list (max one level of nesting). Service-layer validation enforces depth.

nullable
orderintegererforderlich

Sort order within parent (or root for top-level lists)

≥ 0
ownerIduuiderforderlich

User who created the list. Protected after creation.

read-only
orgUnitIduuidoptional

Required when visibility = TEAM, ignored otherwise

nullable
visibilitystringerforderlich

PRIVATE = owner only · TEAM = owner + members of orgUnitId · TENANT = all internal users

Werte
PRIVATETEAMTENANT
archivedAtdatetimeoptional

Soft-archive timestamp. Archived lists hide from the sidebar by default.

nullable

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

  • GET /api/v1/task_lists — Liste, paginiert + filterbar
  • GET /api/v1/task_lists/<id> — Einzelne Entity
  • POST /api/v1/task_lists — Anlegen
  • PATCH /api/v1/task_lists/<id> — Teil-Update
  • DELETE /api/v1/task_lists/<id> — Soft-Delete
  • GET /api/v1/task_lists/<id>/timeline — Audit + Aktivitäten

Suche