social.coves.community.comment.create
Create a comment on a post or another comment. Comments support nested threading, rich text, embeds, and self-labeling.
Details · procedure
| Kind | procedure |
|---|---|
| Authority | comment.community.coves.social |
| Indexed |
Procedure
procedure · POSTInput
application/jsonComment text content
maxLength: 100000maxGraphemes: 10000
embed
unionEmbedded media or quoted posts
facets
arrayAnnotations for rich text (mentions, links, formatting, block structure)
maxLength: 200
labels
refSelf-applied content labels
langs
arrayLanguages used in the comment content (ISO 639-1)
maxLength: 3
References for maintaining thread structure. Root always points to the original post, parent points to the immediate parent (post or comment).
Output
application/jsonErrors
InvalidReply
The reply reference is invalid, malformed, or refers to non-existent content
ContentTooLong
Comment content exceeds maximum length constraints
ContentEmpty
Comment content is empty or contains only whitespace
NotAuthorized
User is not authorized to create comments on this content
InvalidFacets
Rich text facets are malformed, exceed limits, or reference byte ranges outside the content
InvalidImageFacet
An #image facet breaks a placement rule: its index does not name an image of an images embed, it shares its facet with another feature, it places an index already placed, its range is empty, or its range lies inside a #code or #codeBlock range
InvalidEmbed
The embed is not a social.coves.embed.images, social.coves.embed.imagesWithAttachment with a quoted post, or social.coves.embed.post that satisfies its lexicon and the embed write rules; the message describes the failure
TooManyImages
The embed carries more than 8 images
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
social.coves.community.comment.update
procedureUpdate an existing comment's content, facets, embed, languages, or labels. Threading references (reply.root and reply.parent) are immutable and cannot be changed.
-
social.coves.community.post.create
procedureCreate a new post in a community
-
app.bivri.feed.createComment
procedurePost a comment from the authenticated member's repository.
-
social.wips.comment
recordComment on a wips.social update. Top-level comments omit parent; replies set parent to the immediate comment being answered. subject always points at the root update. Body may be text, ordered media, or both (application validators require at least one of non-whitespace text or known image/video media; unknown open-union media variants do not satisfy content alone). Optional rich-text facets (app.bsky.richtext.facet), langs, and labels (open union; current app policy requires selfLabels). Commen
-
A comment on a post or another comment. Comments live in user repositories and support nested threading.