akarso posts list
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).Usage
1akarso posts list
Options
| Option | Default | Description |
--status [status] | - | Filter by status |
--created-after [date] | - | Only posts created after this ISO date |
--created-before [date] | - | Only posts created before this ISO date |
--scheduled-after [date] | - | Only posts scheduled after this ISO date |
--scheduled-before [date] | - | Only posts scheduled before this ISO date |
--platforms [list] | - | Comma-separated platforms to filter by |
--limit [n] | 10 | Maximum number of posts to return |
Global Options
| Option | Default | Description |
--api-key [key] | - | API key (overrides AKARSO_API_KEY env and ~/.akarso/config.json) |
--api-url [url] | - | Server URL (overrides AKARSO_API_URL env, defaults to akarso.co) |
--profile [id] | - | Profile (workspace) ID to operate on, overriding the API key's pinned profile. Use profiles list to see available IDs. |
--json | - | Output raw JSON instead of YAML |
-h, --help | - | Display this message |
-v, --version | - | Display version number |
Examples
1akarso posts list --status scheduled
1akarso posts list --scheduled-after 2026-07-01T00:00:00Z --scheduled-before 2026-08-01T00:00:00Z