social.coves.community.comment.create

Create a comment on a post or another comment. Comments support nested threading, rich text, embeds, and self-labeling.

Repository @coves.social did:web:coves.social namespace authority
Details · procedure
Kindprocedure
Authoritycomment.community.coves.social
Indexed

Procedure

procedure · POST

Input

application/json

content

requiredstring

Comment text content

  • maxLength: 100000
  • maxGraphemes: 10000

facets

array

Annotations for rich text (mentions, links, formatting, block structure)

  • maxLength: 200
itemsref

Self-applied content labels

langs

array

Languages used in the comment content (ISO 639-1)

  • maxLength: 3
itemsstring · language

reply

requiredobject

References for maintaining thread structure. Root always points to the original post, parent points to the immediate parent (post or comment).

Output

application/json

cid

requiredstring · cid

CID of the created comment record

uri

requiredstring · at-uri

AT-URI of the created comment

Errors

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 match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Update an existing comment's content, facets, embed, languages, or labels. Threading references (reply.root and reply.parent) are immutable and cannot be changed.

  • Create a new post in a community

  • Post a comment from the authenticated member's repository.

  • Comment 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.