Posts

List posts

Returns the workspace's posts with comments, most recent activity first.

GET https://api.platica.mx/v1/posts

Query parameters

ParameterTypeDescriptionRequired
workspacestringWorkspace ID. Required for multi-workspace API keys—
limitintegerPosts per page, 1 to 100. Default: 25—
pageTokenstringnextPageToken from the previous response—
channelIdstringComment channel (igc-… or fbc-…). Cannot be combined with platform—
platformstringinstagram or facebook—
startDatestringActivity from this date (ISO 8601)—
endDatestringActivity until this date (ISO 8601)—
sortDirectionstringdesc (default) or asc, by latest activity—

Response

{
  "workspaceId": "ws_001",
  "posts": [
    {
      "id": "conv_post_001",
      "externalId": "17912345678901234",
      "platform": "instagram",
      "channelId": "igc-17841400000000000",
      "title": "New fall collection 🍂",
      "permalink": "https://www.instagram.com/p/Cxyz/",
      "contactName": "My Brand",
      "media": {
        "type": "IMAGE",
        "productType": "FEED",
        "url": "https://scontent.cdninstagram.com/…",
        "thumbnailUrl": null
      },
      "publishedAt": "2026-10-20T15:00:00.000Z",
      "operation": "automatic",
      "paused": false,
      "agentId": null,
      "status": "active",
      "topic": "Pricing",
      "tags": [],
      "owners": [],
      "openThreadsCount": 3,
      "assistanceThreadsCount": 1,
      "unreadCommentsCount": 5,
      "participantsCount": 12,
      "stats": { "reactions": 240, "comments": 31, "shares": 4 },
      "lastComment": {
        "commentId": "17890000000000001",
        "text": "Do you have size M?",
        "authorName": "Ana",
        "role": "user",
        "at": "2026-10-21T18:22:00.000Z"
      },
      "creationDate": "2026-10-20T15:05:00.000Z",
      "lastUpdate": "2026-10-21T18:22:00.000Z"
    }
  ],
  "nextPageToken": null
}
FieldDescription
idPost ID in Platica. Use it as postId
externalIdPost ID in Meta
platforminstagram or facebook
channelIdThe account's comment channel
titlePost caption
operationAgent control: automatic (answers) or supervised (does not answer)
pausedtrue when a person paused the agent on this post
agentIdThe post's own agent. null = the channel's agent answers
openThreadsCountThreads waiting for an answer
assistanceThreadsCountThreads where the agent asked for help
unreadCommentsCountUnread comments in the inbox
statsReactions, comments, and shares according to Meta
lastCommentThe most recent comment

Get a post

GET https://api.platica.mx/v1/posts/{postId}

Responds { "post": { … } } with the same shape as the list, or 404 if the id is not a post.

Update a post

Pauses or resumes the agent on the whole post, or gives it an agent other than the channel's.

PATCH https://api.platica.mx/v1/posts/{postId}

Request body

Send at least one of the two fields.

FieldTypeDescription
operationstringsupervised pauses the agent; automatic resumes it
agentIdstring | nullAgent that answers on this post. null goes back to the channel's agent
{
  "operation": "supervised"
}

Responds { "post": { … } } already updated.