Sign in

v3

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-012582298.4 KB
Comments

Create a comment thread

Create a new comment thread on a draft. A comment thread is the anchored discussion container; comments are the messages inside the thread.

For post platforms (x, linkedin, mastodon, threads, bluesky, substack), provide post_index and anchor to a substring of that post's visible text using selected_text. Use occurrence to disambiguate when the same substring appears more than once; omit it to anchor on the first match.

For X Articles, send platform: "x_article" and omit post_index (or use 0). selected_text matches rendered article text in document order; Markdown syntax, media tags, and X post embed tags are ignored. X Article text comments cannot overlap existing stored X Article anchors; overlapping selections return 400 VALIDATION_ERROR.

LinkedIn mentions appear in posts[*].text as @[Name](urn:li:organization:ID) or @[Name](urn:li:person:ID). A mention is indivisible — selected_text must either contain the entire mention substring or stay outside it.

Required permission: WRITE access to this social set.

post/v2/social-sets/{social_set_id}/drafts/{draft_id}/comment-threads

Path parameters

social_set_idinteger required
draft_idinteger required

Request body

OR

Response

Created

idstring uuid required

Unique identifier for the comment thread.

draft_idinteger required

Identifier of the draft this comment thread belongs to.

platform'x' | 'linkedin' | 'mastodon' | 'threads' | 'bluesky' | 'substack' | 'x_article' required

Platform the comment thread is anchored on.

status'unresolved' | 'resolved' required

Resolution status of the comment thread.

selected_textstring nullable

The text the comment thread was originally anchored to. Captured when the thread was created and not re-derived afterwards, so it may not match the current post text if the post has been edited. Null for threads that were created against a whole post rather than a specific span.