List posts
list_postsList posts of the API key's workspace (JSON with items, total, limit, offset; each item carries targets[] with channel, accountId, status and, for a failed target, failureReason and failureReasonCode, and needsReschedule on the post and each target, so the same caption on several networks is one post per network, not a duplicate; a WORDPRESS target carries its article summary but not the body: use get_post for contentHtml), optionally filtered by status (draft, scheduled, paused, publishing, published, failed, missed_slot: scheduled posts approved after their time, or still unapproved past it, that will not auto-publish until the user picks a new time; plain scheduled excludes them), channel, brandId and a scheduledAt range (from/to).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_posts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | scheduledAt upper bound, ISO 8601 with zone. | |
| from | No | scheduledAt lower bound, ISO 8601 with zone. | |
| limit | No | Page size, 1-100. | |
| offset | No | Number of posts to skip. | |
| status | No | Only posts with this status, e.g. FAILED, PAUSED or MISSED_SLOT (case-insensitive). | |
| brandId | No | Only posts touching this brand. | |
| channel | No | Only posts that have a target on this channel (UPPERCASE canonical, lowercase accepted). |