comments

Post Record Comment

Post a comment. Requires only the ability to READ the record — a viewer who cannot edit it can still comment.

post/api/v1/entities/{entity_id}/comments

Path parameters

entity_idstring uuid required

Query parameters

embed_host_app_idstring uuid nullable

Request body

row_keystring required

The record's _row_key.

bodystring required
app_idstring uuid nullable

Set when commenting from inside an app — selects the app authorization lane. Omit on the ontology record page.

parent_comment_idstring uuid nullable

Reply to this comment. Must be a live comment on the SAME record. Replying to a reply is allowed — rendering is flat, so quote resolution never follows more than one hop.

Response

Successful Response

idstring uuid required
bodystring required
created_atstring date-time required
updated_atstring date-time required
like_countinteger
liked_by_meboolean
can_editboolean required

Whether THIS caller may edit it. Computed server-side because the app runtime's CurrentUser carries no user id, so the widget cannot decide ownership locally.

can_deleteboolean required

Whether THIS caller may delete it.

Changes