Comments
Household members' comments on a recipe.
List a recipe's comments, oldest first
new marks comments by somebody else since the caller last opened the recipe's comments, for the recipe's author and members with a comment on it. Listing does not mark anything seen.
Change the text and photos of one's own comment
Replaces the body and, when imageIds is present, the photo set. editedAt moves only when the body or the photos changed.
Delete a comment
The person who wrote it, or an admin.
Stage a photo for a comment (JPEG, PNG or WebP, at most 10 MiB)
Write a comment on a recipe
Any member may write on any recipe, locked ones included. The comment is the caller's.
Mark a recipe's comments as seen by the caller
The recipe page calls this when the reader first opens its comments tab, with the highest comment id it loaded. Comments above it stay new. The editor, cook mode and MCP reads do not call it. It needs only recipes:read on purpose: it moves the caller's own unread marker and changes nothing anybody else sees, so a read-only client that shows comments can clear them.
Read a comment photo in one of its rendered sizes
/api/v1/recipes/{id}/tasty PUT
Everyone sees how many members marked a recipe tasty and who. The author cannot mark their own recipe: 403.
/api/v1/comments GET
new marks comments by somebody else since the caller last opened the recipe's comments, for the recipe's author and members with a comment on it. Listing does not mark anything seen.