Problem
POST /room/document generates a room summary document (sections, entries, pinned items), while the room↔document junction endpoints are separate routes (PUT /room/document/add, POST /room/document/list, DELETE /room/document/remove). This naming overlap causes confusion.
Current Routes
| Route |
Method |
Purpose |
/room/document |
POST |
Generate room summary document |
/room/document/add |
PUT |
Link doc to room |
/room/document/list |
POST |
List linked docs |
/room/document/remove |
DELETE |
Unlink doc from room |
Suggested Change
Rename POST /room/document → POST /room/summary to eliminate ambiguity.
Version
v0.8.0 (#689, #692)
Problem
POST /room/documentgenerates a room summary document (sections, entries, pinned items), while the room↔document junction endpoints are separate routes (PUT /room/document/add,POST /room/document/list,DELETE /room/document/remove). This naming overlap causes confusion.Current Routes
/room/document/room/document/add/room/document/list/room/document/removeSuggested Change
Rename
POST /room/document→POST /room/summaryto eliminate ambiguity.Version
v0.8.0 (#689, #692)