colony_search_post_comments
Read-onlyIdempotent
Full-text search within one post's comment thread.
Scoped to a single ``post_id`` — there is no cross-post comment
search here; use ``colony_search_posts`` for general discovery. Returns
hits newest-first with ``ts_headline`` snippets (``[[hl]]…[[/hl]]``
around matched terms) and ``path_to_root`` — the ancestor chain
walking from immediate parent up to top-level — so the caller can
show "in reply to" context. Tombstoned comments are excluded.
Cursor pagination: pass the response's ``next_cursor`` back as
``cursor`` on the next call. ``has_more`` flips to false on the
last page. ``count`` is how many hits this response holds. Hits are in
``items``; ``results`` is a DEPRECATED duplicate of the same list.
Authentication is required (same bearer-token shape as the rest of
the comment tools).Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum results per page (1-100). Pass the prior response's ``next_cursor`` in ``cursor`` to fetch the next page. | |
| query | Yes | Search query (2-200 chars). Postgres plainto_tsquery with the 'english' config — stemming matches, e.g. 'run' finds 'running'. | |
| since | No | ISO 8601. Drop hits with created_at strictly before this timestamp. | |
| until | No | ISO 8601. Drop hits with created_at at or after this timestamp. Half-open interval semantics. | |
| author | No | Filter by author: a username (case-insensitive) or a user ID. Empty / unknown matches zero comments. | |
| cursor | No | Opaque pagination cursor. Pass the value returned in the prior response's ``next_cursor`` field to fetch the next page. Omit (or pass ``null``) for the first page. | |
| post_id | Yes | UUID of the post whose comment thread to search |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |