Repository navigation
Lists: creation options the API accepts but the app drops (parentId, folderId, messageId, initialRows, metadata) #54
Description
Activity
Implemented in #98 (branch
issue/54-list-creation-options). Closing here — review and any follow-up happens on the PR.Three things need your input, carried into the PR so they are not lost:
- From Template tab was not built — as the issue suspected, there is no list-template endpoint anywhere. The spec has only
/api/documents/templates,/api/documents/templates/seed-defaultsand/api/documents/from-template, and the help centre has no list-template page. Where do the web's list templates come from? initialRowsshape is unverified. The generated spec types it as"type": "string", and the human-written reference never mentions it. It is modelled as an array of flat column-keyed objects, matching howPOST /api/lists/{id}/dataserialises a row. Worth confirming before AI: Powered Templates tab on list creation #8 (Powered Templates) depends on it.folderIdis not a documented create field — it is a real column, but folder placement is documented onPUT /api/lists/{id}instead. Included as the issue asked, with a KDoc caveat.
Also corrected along the way:
CreateListRequest.schemawas typedString?, but the help reference is explicit thatPOST /api/liststakes the DSL as an object (the comma-separated string form belongs toPUT /api/lists/{id}/schema). No caller ever set it, so the fix is behaviour-neutral.Not done, worth its own issue:
PUT /api/lists/{id}acceptsparentId, so re-parenting an existing list is still unsupported.- From Template tab was not built — as the issue suspected, there is no list-template endpoint anywhere. The spec has only
- added a commit that references this issue
on Sep 16, 2026
Part of #49 — Lists parity gaps: GitHub-backed lists, saved views, view modes and collaborative editing
CreateListRequestsends onlytitle, description, schema, isPublic.parentId— child lists form a tree with breadcrumb navigation on the web; Android cannotset a parent at creation.
messageId— "Create list from message": the list-plus icon on any message creates a listusing that message as the description, with a suggested name. (Related to, but distinct from,
the Create-from epic.)
initialRows— starter rows at creation, which Powered Templates depends on.metadata/source— pass-through fields.endpoint in the OpenAPI spec, so confirm with the owner where those templates come from before
building.
Tests: each field reaches the request; parent breadcrumb navigation.
Filed from the parity review of
feature/parity-wip@14d7795against interlinedlist.com (OpenAPI/api/openapi.json, 233 paths) and the public help centre.