Comments

Threaded comments attached to feedback posts. Comments are polymorphic — the same shape supports replies and top-level comments.

A comment is a piece of text attached to a feedback post — typically discussion or follow-up from your team or end-users. Comments support a single level of replies (parent_comment_id) and have their own moderation state independent of the parent post.

The API lets you retrieve, list, create, and bulk-delete comments. Updating a single comment's content is dashboard-only in v1.

The comment object

idstring

Required

A unique identifier for the comment (UUID).

contentstring

Required

The comment body.

author_idstring

Required

UUID of the user who wrote the comment.

parent_comment_idstring

UUID of the parent comment when this is a reply. null for top-level comments.

feedback_post_idstring

Required

UUID of the feedback post this comment is attached to.

visibility_codestring

Required

Visibility level. Defaults to "public". Used to hide internal-only notes from end-users.

moderation_status_codestring

Required

Moderation state. Common values: "accepted", "pending", "rejected".

created_atstring

Required

ISO 8601 timestamp at which the comment was created.

updated_atstring

Required

ISO 8601 timestamp of the most recent update.

Example comment object

{
  "id": "ee3c3ef8-b8cd-cd15-01ba-comment000001",
  "content": "+1 from the entire data team. We'd use this daily.",
  "author_id": "bb3c3ef8-b8cd-cd15-01ba-useruser0001",
  "parent_comment_id": null,
  "feedback_post_id": "aa3c3ef8-b8cd-cd15-01ba-postpost0001",
  "visibility_code": "public",
  "moderation_status_code": "accepted",
  "created_at": "2026-04-16T10:00:00.000Z",
  "updated_at": "2026-04-16T10:00:00.000Z"
}

What you can do

Retrieve a comment

Look up a single comment by its UUID.

List comments

Paginated list scoped to a single feedback post.

Create a comment

Post a new comment, optionally as a reply to an existing one.

Delete by post

Bulk soft-delete every comment on a single post. Destructive.

Was this page helpful?

Last updated 1 week ago

Built with Documentation.AI