Posts
Create, schedule, update, and delete posts
📄️ List posts
Returns scheduled, published, or draft posts. Supports filtering by status and platform, with pagination.
📄️ Create post
Create a social media post. Specify content, target accounts, and optionally a schedule time. **Three modes:** (1) omit `scheduled_for` to publish immediately; (2) include `scheduled_for` to schedule for later; (3) set `draft: true` to save it as a DRAFT for human review — it is NOT published until you call `POST /posts/{id}/schedule` on it (review drafts via `GET /posts?status=draft`). For drafts, `account_ids` is optional.
📄️ Get post
Returns detailed information about a specific post, including content, media, schedule, and per-platform destination statuses.
📄️ Update post
Update a scheduled or draft post. You can change content, schedule, target accounts, or media. Published posts cannot be modified.
📄️ Delete post
Permanently delete a scheduled or draft post. Published posts cannot be deleted. This action cannot be undone.
📄️ Get post results
Returns per-platform publishing results for a post, including published URLs, error messages, attempt counts, and retry schedules.
📄️ Retry failed post
Retry all failed platform destinations for a post. Resets failed destinations to queued status for re-publishing. Use after resolving temporary issues like rate limits or expired tokens.