List Posts
list_postsFind post IDs and review queued content by filtering status, platform, or date range. Returns posts newest first with per-platform status to audit what is scheduled or completed.
Instructions
List posts in the token's workspace, any status, newest first by default. Returns { posts, total, hasMore }; each post carries its status and a platforms array with per-platform status. Filters: statuses, platforms (posts targeting any of them), and startDate/endDate, which bound scheduledAt, or createdAt for posts never scheduled. limit is 1 to 100 (default 20); page with offset while hasMore is true. Use this to find post ids or check what is already queued. Use get_post for one post's full record and list_post_results for one post's per-platform outcomes and retry ids.
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 |
|---|---|---|---|
| limit | No | Max results, 1 to 100 | |
| offset | No | Posts to skip; increase by limit while hasMore is true | |
| endDate | No | Upper bound (ISO 8601, e.g. "2026-03-31") on scheduledAt, or createdAt for posts never scheduled | |
| statuses | No | Filter by status (e.g. ["SCHEDULED", "DRAFT"]); omit for all statuses | |
| platforms | No | Filter to posts targeting any of these platforms | |
| sortOrder | No | NEWEST (default) or OLDEST | |
| startDate | No | Lower bound (ISO 8601, e.g. "2026-03-01") on scheduledAt, or createdAt for posts never scheduled |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No | An object with posts (each with id, status, contentType, text, scheduledAt, timezone, and platforms with per-platform status), total (count of all matches), and hasMore. |