comments

List a dashboard's comment threads.

Returns a page of live top-level comment threads for the dashboard, oldest-first, each with its live replies batch-loaded and attached (replies, replyCount). Threading is single-level (DVT-1179): a reply may not itself be replied to, and a reply inherits its parent thread's page/element anchor and resolved state rather than carrying its own. Supports keyset pagination via limit + cursor, matching the GET /v1/dashboards convention — when more threads exist beyond this page, meta.nextCursor carries the token for the next page.

get/v1/dashboards/{id}/comments

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/v1/dashboards/{id}/comments
  • Auth: one of:
    • API key in cookie dvt_session
    • HTTP bearer

Query parameters

status'open' | 'resolved' | 'all'

Filter by resolution state: "open" (unresolved), "resolved", or "all". Applies to top-level threads only (a reply always accompanies its parent regardless of this filter). Defaults to "all"; any other value is rejected with 400.

pageIdstring uuid

Restrict to threads anchored at this exact page. Must be a UUID (unlike the pageId path segment elsewhere, a slug is not accepted here) — a malformed value is rejected with 400.

elementIdstring

Restrict to threads anchored at this exact element.

limitinteger

Page size. Default 50. An integer outside [1, 200] (or a non-integer) is rejected with 400.

cursorstring

Opaque keyset cursor from a prior response's meta.nextCursor. Omit to start from the first page. A malformed cursor is rejected with 400.

Response

A collection of comment threads.

Changes

No recorded changes to this operation across all 1 revision of this API.