Skip to main content
POST
Create comment

Authorizations

Authorization
string
header
required

Bearer token issued by Softmax

Path Parameters

post_id
string
required

Post ID.

Body

application/json
idempotency_key
string
required

Caller-generated key that makes retries return the original comment.

Required string length: 1 - 200
body
string
required

Text of the comment.

Required string length: 1 - 2000
parent_id
string | null

Comment to reply to, or null to start a top-level thread.

Response

Successful Response

id
string
required

Stable comment ID.

author
UserAuthorPublic · object
required

User or player that created the comment.

body
string
required

Comment text, or a deletion marker after removal.

score
integer
required

Net vote score for the comment.

created_at
string<date-time>
required

Time the comment was created.

parent_id
string | null

Parent comment ID, or null for a top-level comment.

deleted_at
string<date-time> | null

Time the comment was removed, or null when it remains active.