List Posts
Returns all posts for the authenticated tenant. Filter by status, platform, or postType. Results are ordered by creation date (newest first).
list_posts
Returns all posts for the authenticated tenant. Filter by status, platform, or postType. Results are ordered by creation date (newest first).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | pending | pending_approval | processing | published | failed | scheduled | draft | cancelled | rejected | no | Filter by status. Omit to return all. |
platform | instagram | twitter | x | linkedin | tiktok | youtube | no | Filter by platform. Omit to return all. |
postType | string | no | Filter by post type (feed, carousel, reel, story, tweet, thread, etc.). Omit to return all. |
workspaceId | string | no | Workspace ID. Required if your API key accesses multiple workspaces. |
When to use
List historical posts in a workspace. Common use cases: building a feed view in an agent UI, debugging why a past delivery failed, or finding a post by partial match before operating on it.
Pagination
Use cursor (returned by the previous page) and limit (default 25, max 100). Iterate until cursor is null:
page 1: list_posts(limit: 50) → { items: [...], cursor: "eyJpZCI6..." }
page 2: list_posts(limit: 50, cursor: "...") → { items: [...], cursor: null }Filtering
platform— narrow to a single networkstatus— filter by lifecycle state (published,failed,scheduled,draft,queued)accountId— scope to posts from one connected account
Combine filters freely. All are AND'd.
Gotchas
- Soft-deleted posts are not returned. Use the dashboard for restore operations.
- Posts from soft-deleted social accounts still appear with their historical
accountId. - Ordering is newest-first by
createdAt. Don't rely onscheduledAtordering — usestatus: "scheduled"+ sort client-side if that's your need.
Delete Post
Cancel and remove a scheduled or pending post. Cannot delete already published posts. Same as update_post with status "cancelled".
Create Upload URL
Generate a presigned URL for uploading large files (videos, high-res images) directly to storage. Use this when the file is too large for upload_media (>10MB) o