comments

Post Record Comment

Changed on

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

Request

  • Base URL
    https://api.netter.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.netter.ai/api/v1/entities/{entity_id}/comments
  • Auth
    none declared

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

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      endpoint added