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

ParameterTypeDescriptionRequired
workspacestringWorkspace ID. Required for multi-workspace API keys—
limitintegerThreads per page, 1 to 100. Default: 25—
pageTokenstringnextPageToken from the previous response—
sortBystringrootCreatedAt (default, root comment date) or lastCommentAt—
sortDirectionstringdesc (default) or asc. asc only with rootCreatedAt and without status—
statusstringopen or resolved—
needsReplybooleantrue: the last comment is from the person and nobody has answered—
operationstringautomatic, supervised, or assistance. Only threads with their own value; those inheriting from the post are not included—
ownerstringOwner email—

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
}
FieldDescription
statusopen or resolved. A new comment from the person reopens the thread
needsReplyThe last comment is from the person and nobody has answered
operationThe thread's own value. null = inherits from the post
effectiveOperationWhat applies: automatic, supervised, or assistance
ownersOwner emails
rootText and moderation of the root comment
replyStateprocessing while the agent answers; failed if it could not
resolvedReasonWhy it was resolved without an answer (for example spam), or null
privateRepliesBy 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.

FieldTypeDescription
statusstringresolved marks it resolved; open reopens it
operationstring | nullsupervised 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
ownersarrayOwner emails (up to 25). Replaces the list
{
  "status": "resolved"
}

Responds { "thread": { … } } already updated, with its comments.