Comments

Comments are threaded discussions attached to entities. The comments module lets you create, fetch, update, and delete comments, and manage reactions on them. All actions are performed on behalf of the logged-in user.

createComment

Creates a comment on an entity. Optionally a reply, with a GIF, mentions, attachments, or metadata.

const comment = await sublay.comments.createComment({
  entityId: "ent_xyz789",
  content: "Great post!",
});

string

required

The Sublay entity ID the comment belongs to.

string

Your application’s identifier for this comment.

string

The comment’s text content.

GifData | null

An optional GIF attached to the comment.

Mention[]

User mentions embedded in the comment.

string | null

The ID of the parent comment when this is a reply.

string

The ID of another comment this comment references.

Record<string, any>[]

File or media attachments.

Record<string, any>

Arbitrary public metadata.

Returns — Promise<Comment>

fetchComment

Fetches a single comment by its ID.

const comment = await sublay.comments.fetchComment({ commentId: "cmt_abc123" });

string

required

The Sublay comment ID.

string

Comma-separated list of associations to populate.

Returns — Promise<Comment>

fetchCommentByForeignId

Fetches a comment by your application’s own identifier.

const comment = await sublay.comments.fetchCommentByForeignId({
  foreignId: "comment-99",
});

string

required

Your application’s comment identifier.

string

Comma-separated list of associations to populate.

Returns — Promise<Comment>

updateComment

Updates a comment’s content.

const comment = await sublay.comments.updateComment({
  commentId: "cmt_abc123",
  content: "Edited comment text",
});

string

required

The Sublay comment ID to update.

string

required

The new content for the comment.

Returns — Promise<Comment>

deleteComment

Deletes a comment.

await sublay.comments.deleteComment({ commentId: "cmt_abc123" });

string

required

The Sublay comment ID to delete.

Returns — Promise<void>

fetchManyComments

Fetches a paginated list of comments, filterable by entity, user, or parent.

const { data, pagination } = await sublay.comments.fetchManyComments({
  entityId: "ent_xyz789",
  sortBy: "top",
  page: 1,
  limit: 20,
});

string

Filter to comments on a specific entity.

string

Filter to comments authored by a given user.

string

Filter to replies of a specific parent comment.

number

Page number (1-indexed).

number

Results per page.

string

Sort order: "createdAt" (newest first; honors sortDir), "top", or "controversial". "new" and "old" are deprecated aliases for "createdAt" (removed in v8) — the server still accepts them but responds with a deprecation header.

string

Comma-separated list of associations to populate.

string

Filter by source ID.

"exclude" | "include-outbound-blocked"

How to treat comments authored by users the viewer is block-edged with. "exclude" (default) hides them; "include-outbound-blocked" re-includes only the viewer’s own outbound-blocked authors — never content from users who blocked the viewer. No effect without the moderation bundle.

Returns — Promise<PaginatedResponse<Comment>>

addReaction

Adds the logged-in user’s reaction to a comment and returns the full populated comment.

const comment = await sublay.comments.addReaction({
  commentId: "cmt_abc123",
  reactionType: "like",
});

string

required

The Sublay comment ID.

ReactionType

required

One of: "upvote", "downvote", "like", "love", "wow", "sad", "angry", "funny".

Returns — Promise<Comment>

removeReaction

Removes the logged-in user’s reaction from a comment and returns the full populated comment.

const comment = await sublay.comments.removeReaction({
  commentId: "cmt_abc123",
});

string

required

The Sublay comment ID.

Returns — Promise<Comment>

fetchReactions

Fetches a paginated list of reactions on a comment, optionally filtered by reaction type.

const { data, pagination } = await sublay.comments.fetchReactions({
  commentId: "cmt_abc123",
  reactionType: "like",
  page: 1,
  limit: 20,
});

string

required

The Sublay comment ID.

ReactionType

Filter to a specific reaction type.

number

Page number (1-indexed).

number

Results per page.

string

Sort direction: "asc" or "desc".

Returns —

Promise<{ data: Reaction[]; pagination: { page: number; limit: number; total: number; totalPages: number; hasMore: boolean } }>

getUserReaction

Gets the logged-in user’s reaction on a comment. Returns null if there is no reaction.

const { reactionType } = await sublay.comments.getUserReaction({
  commentId: "cmt_abc123",
});
// reactionType is "like" | "upvote" | ... | null

string

required

The Sublay comment ID.

Returns — Promise<{ reactionType: ReactionType | null }>

Getting Started

Modules

createComment

fetchComment

fetchCommentByForeignId

updateComment

deleteComment

fetchManyComments

addReaction

removeReaction

fetchReactions

getUserReaction

​createComment

​fetchComment

​fetchCommentByForeignId

​updateComment

​deleteComment

​fetchManyComments

​addReaction

​removeReaction

​fetchReactions

​getUserReaction

createComment

fetchComment

fetchCommentByForeignId

updateComment

deleteComment

fetchManyComments

addReaction

removeReaction

fetchReactions

getUserReaction