list-comments
Use list-comments to review feedback, see open discussion points, or check mentions on a design. Each result is a top-level thread. To read the replies inside one thread, pass its id to list-replies.
Example prompt
"What feedback has the team left on my launch deck?"
Pass the design_id. Optionally set limit (1 to 100, default 50) for the page size.
Example response
IDs and tokens below are placeholders; field names and structure are exactly as returned.
{"items": [{"id": "COMMENT_EXAMPLE","design_id": "DAF_EXAMPLE","thread_type": {"type": "comment","content": { "plaintext": "Can we make the headline bigger?" },"mentions": {},"assignee": { "id": "USER_EXAMPLE_2", "display_name": "Example Assignee" }},"author": { "id": "USER_EXAMPLE_1", "display_name": "Example User" },"created_at": 1758000000,"updated_at": 1758000000}],"continuation": "EXAMPLE_TOKEN"}
Each item is a thread with an id (the comment_id for the other comment tools), an author, and a thread_type whose content.plaintext holds the text. Replies aren't included in this response; fetch them with list-replies. If the response includes a continuation token, pass it back unchanged with the same design_id to get the next page; if it's absent, there are no more threads.