Threads
A thread is a root comment and its replies. Its id is the Meta id of the root comment.
List threads
GET https://api.platica.mx/v1/posts/{postId}/threads Query parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
workspace | string | Workspace ID. Required for multi-workspace API keys | — |
limit | integer | Threads per page, 1 to 100. Default: 25 | — |
pageToken | string | nextPageToken from the previous response | — |
sortBy | string | rootCreatedAt (default, root comment date) or lastCommentAt | — |
sortDirection | string | desc (default) or asc. asc only with rootCreatedAt and without status | — |
status | string | open or resolved | — |
needsReply | boolean | true: the last comment is from the person and nobody has answered | — |
operation | string | automatic, supervised, or assistance. Only threads with their own value; those inheriting from the post are not included | — |
owner | string | Owner email | — |
Nota
Use one filter at a time among status, needsReply, operation, and owner. To combine them,
filter one in the query and the rest in your code.
Response
{
"workspaceId": "ws_001",
"postId": "conv_post_001",
"threads": [
{
"id": "17890000000000001",
"postId": "conv_post_001",
"status": "open",
"needsReply": true,
"commentCount": 2,
"topic": "Sizes",
"tags": ["Purchase intent"],
"operation": null,
"effectiveOperation": "automatic",
"owners": [],
"clientId": "cli_123",
"authorName": "Ana",
"authorPhotoUrl": null,
"authorType": null,
"authorRole": "user",
"root": { "text": "Do you have size M?", "isSpam": false, "moderationAction": "none" },
"replyState": null,
"resolvedAt": null,
"resolvedReason": null,
"privateReplies": {},
"rootCreatedAt": "2026-10-21T18:20:00.000Z",
"lastCommentAt": "2026-10-21T18:22:00.000Z"
}
],
"nextPageToken": null
} | Field | Description |
|---|---|
status | open or resolved. A new comment from the person reopens the thread |
needsReply | The last comment is from the person and nobody has answered |
operation | The thread's own value. null = inherits from the post |
effectiveOperation | What applies: automatic, supervised, or assistance |
owners | Owner emails |
root | Text and moderation of the root comment |
replyState | processing while the agent answers; failed if it could not |
resolvedReason | Why it was resolved without an answer (for example spam), or null |
privateReplies | By commentId, the private reply that was sent: status, sentAt, the DM conversationId |
Get a thread
Returns the thread with its comments in order (up to 500). Each comment has the shape of comment in the comment.created payload.
GET https://api.platica.mx/v1/posts/{postId}/threads/{threadId} {
"thread": {
"id": "17890000000000001",
"status": "open",
"needsReply": true,
"comments": [
{
"id": "17890000000000001",
"postId": "17912345678901234",
"parentCommentId": null,
"rootCommentId": "17890000000000001",
"platform": "instagram",
"channelId": "igc-17841400000000000",
"content": "Do you have size M?",
"contentType": "text",
"attachments": [],
"direction": "incoming",
"role": "user",
"clientId": "cli_123",
"authorName": "Ana",
"isSpam": false,
"moderation": { "action": "none", "synced": false, "moderatedAt": null },
"creationDate": "2026-10-21T18:20:00.000Z"
}
],
"commentsTruncated": false
}
} Update a thread
PATCH https://api.platica.mx/v1/posts/{postId}/threads/{threadId} Request body
Send at least one field.
| Field | Type | Description |
|---|---|---|
status | string | resolved marks it resolved; open reopens it |
operation | string | null | supervised pauses the agent on this thread only; automatic resumes it; null inherits from the post again. On a thread in assistance, supervised accepts the assistance |
owners | array | Owner emails (up to 25). Replaces the list |
{
"status": "resolved"
} Responds { "thread": { … } } already updated, with its comments.