posts_list — Akarso

posts_listTOOL

List posts in the current workspace, with optional filters.

Returns posts sorted by creation date (newest first). Each post includes its status, content, per-platform results, and scheduled/published date. Drafts saved with posts create --draft live under drafts list instead.

Statuses: draft, pending, scheduled, publishing, published, failed, partial. Filter with --status.

Use --created-after/--created-before and --scheduled-after/--scheduled-before for date range filtering, --platforms to filter by target platform(s), and --limit to control how many results are returned (default: 10).

Parameters

Filter by status

createdAfter?string

Only posts created after this ISO date

createdBefore?string

Only posts created before this ISO date

scheduledAfter?string

Only posts scheduled after this ISO date

scheduledBefore?string

Only posts scheduled before this ISO date

platforms?string

Comma-separated platforms to filter by

limit?number

Maximum number of posts to return

Default: 10

Ask AI about this page

Request example

{
  "method": "tools/call",
  "params": {
    "name": "posts_list",
    "arguments": {
      "status": "draft",
      "createdAfter": "string",
      "createdBefore": "string",
      "scheduledAfter": "string",
      "scheduledBefore": "string",
      "platforms": "string",
      "limit": 10
    }
  }
}