List comments

Comments are threaded discussions. Each comment can have:

• Author information
• Voting (upvotes/downvotes)
• Privacy settings (public/private)
• Moderation status
• Parent comment reference for threading

Filtering

Optionally filter by:

• postId - Get comments for a specific post
• changelogId - Get comments for a specific changelog

If no filter is provided, returns all comments across the organization.

Pagination

This endpoint uses cursor-based pagination:

• limit - Number of comments to return (1-100, default 10)
• cursor - Opaque cursor from a previous response's nextCursor field

Example: To paginate through results:

1. First request: GET /v2/comments?postId={id}&limit=10
2. If nextCursor is not null, use it for the next page
3. Next request: GET /v2/comments?postId={id}&limit=10&cursor={nextCursor}

Response Format

Returns a list object with:

• object - Always "list"
• data - Array of comment objects (flat structure with parentCommentId for threading)
• nextCursor - Cursor for the next page (null if no more results)

Comment Structure

Each comment includes:

• id - Unique comment identifier
• postId / changelogId - Reference to the parent content
• parentCommentId - Reference to parent comment (null for root comments)
• content - Comment content in HTML format
• author - Author information (id, name, profilePicture, type)
• upvotes / downvotes / score - Voting metrics
• isPrivate - Whether comment is only visible to admins
• inReview - Whether comment is pending moderation
• created / updated - Unix timestamps

Additional Filters

• privacy - Filter by privacy: "public", "private", or "all"
• inReview - Filter by moderation status (true/false)

Sorting

Use sortBy to sort results:

• best - Sort by confidence score (default, like Reddit)
• top - Sort by net score (upvotes - downvotes)
• new - Sort by creation date, newest first
• old - Sort by creation date, oldest first