Posts
List posts
Returns the workspace's posts with comments, most recent activity first.
GET https://api.platica.mx/v1/posts Query parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
workspace | string | Workspace ID. Required for multi-workspace API keys | — |
limit | integer | Posts per page, 1 to 100. Default: 25 | — |
pageToken | string | nextPageToken from the previous response | — |
channelId | string | Comment channel (igc-… or fbc-…). Cannot be combined with platform | — |
platform | string | instagram or facebook | — |
startDate | string | Activity from this date (ISO 8601) | — |
endDate | string | Activity until this date (ISO 8601) | — |
sortDirection | string | desc (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
} | Field | Description |
|---|---|
id | Post ID in Platica. Use it as postId |
externalId | Post ID in Meta |
platform | instagram or facebook |
channelId | The account's comment channel |
title | Post caption |
operation | Agent control: automatic (answers) or supervised (does not answer) |
paused | true when a person paused the agent on this post |
agentId | The post's own agent. null = the channel's agent answers |
openThreadsCount | Threads waiting for an answer |
assistanceThreadsCount | Threads where the agent asked for help |
unreadCommentsCount | Unread comments in the inbox |
stats | Reactions, comments, and shares according to Meta |
lastComment | The 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.
| Field | Type | Description |
|---|---|---|
operation | string | supervised pauses the agent; automatic resumes it |
agentId | string | null | Agent that answers on this post. null goes back to the channel's agent |
{
"operation": "supervised"
} Responds { "post": { … } } already updated.
Nota
Resuming only applies to new comments. What arrived while the agent was paused stays unanswered
until you send it with send-to-agent .