Sign in
Comments

Reply to comment

Post a reply to a post or specific comment. Requires accountId in request body.

Idempotency: send an Idempotency-Key header to make retries safe (e.g. after a client-side timeout where delivery is unknown): same key + same body replays the original response (with Idempotent-Replayed: true) instead of posting the comment a second time; same key + different body returns 422; a key still in flight returns 409. Keys are retained for 24 hours and are scoped to the credential and to this exact path, so reusing a key against a different postId returns 422 rather than replaying the other post's response.

Only successful (2xx) responses are stored for replay. If the request throws or returns a non-2xx status the key is released, so the header protects the "request succeeded but the response was lost" case. After an ambiguous failure (a 5xx or a network timeout) list the post's comments before retrying with the same key, and treat an empty result as inconclusive rather than as proof nothing was posted.

post/v1/inbox/comments/{postId}

Path parameters

postIdstring required

Zernio post ID or platform-specific post ID. LinkedIn third-party posts accept full activity URN or numeric ID.

Headers

Idempotency-Keystring

Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.

Request body

accountIdstring required
messagestring required
attachmentUrlstring uri

(Facebook only) URL of an image to attach, publishing a photo comment alongside the text. The URL must be publicly accessible so Meta can fetch it. Returns 400 for other platforms.

commentIdstring

Reply to specific comment (optional)

parentCidstring

(Bluesky only) Parent content identifier

rootUristring

(Bluesky only) Root post URI

rootCidstring

(Bluesky only) Root post CID

Response

Reply posted

successboolean

Changes

Changed in 1 of the 28 revisions of this API.3

  • e6f7a453bfb13See the full diff
    • ○

      added the new optional header request parameter Idempotency-Key

      new-optional-request-parameter

    • ○

      added the non-success response with the status 409

      response-non-success-status-added

    • ○

      added the non-success response with the status 422

      response-non-success-status-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog