Comments

Comment on a post

Publishes a comment on a post. Send application/json; attach one image as a base64 object. Returns the full created Comment object. Comment text passes through to the platform and is never stored.

post/v1/{account_id}/posts/{post_id}/comments

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/posts/{post_id}/comments
  • Auth: HTTP bearer

Path parameters

account_idstring required

The account ID (acc_...) to comment as.

post_idstring required

The post's id from get_post or any list response. A bare activity id, a URN (activity/ugcPost/share), or a full share URL all work.

Request body

textstring required

Comment body text (1-1250 chars). Inline @mentions live in the text (e.g. "@ACoAA..."). Not stored or logged.

comment_asstring

Publish as another user or company page id, the account must administer it.

Response

Comment published successfully. Returns the full created Comment object.

object'comment'

Response type discriminator.

idstring

Comment identifier (bare numeric string), use this as the comment_id path param on sub-resource endpoints.

created_atstring nullable

ISO-8601 UTC datetime the comment was created, or null.

textstring nullable

Full comment text (content pass-through, never stored).

reply_countnumber

Total reply count on this comment.

reaction_countnumber

Total reaction count on this comment, the sum of reactions[].count.

can_replyboolean

true if the authenticated account can reply to this comment.

can_reactboolean

true if the authenticated account can react to this comment.

is_senderboolean

true if the authenticated account authored this comment.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.