List comments
list_commentsRead comment threads for a tela wiki page (full threads) or space (inbox), filter by status, and poll for new or edited activity via cursor.
Instructions
Read comments (editor+). Pass page_id for one page's full threads (each root with its replies), or space_id for an inbox of threads across a whole space (roots only, each with reply_count and page_title — drill into the page for the replies). status is open (default), resolved, or all. TO POLL FOR WHAT HUMANS WROTE: keep the cursor this returns and pass it back as since next time — you then get only threads with new or edited activity, including threads someone replied to, and each comes back with its full context. Anchors are the page's PLAIN TEXT, not its markdown (inline markers stripped, blocks joined by single newlines), so match anchor_exact loosely against a get_page body rather than searching for it verbatim. Answer a thread with add_comment(parent_id=…) and close it with update_comment(resolved=true).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | max threads (default 50, max 200) | |
| since | No | opaque cursor from a previous call; returns only threads with new or edited activity since then | |
| status | No | open (default) | resolved | all | |
| page_id | No | page whose threads to read (root + replies); give this or space_id, not both | |
| space_id | No | space whose open threads to read as an inbox (roots only, with reply_count and page_title); give this or page_id, not both |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | pass back as since on the next call to see only what changed | |
| threads | Yes |