API & MCP reference / REST API

Posts

POST/v1/posts

Create a post. Omit both scheduled_at and use_queue to publish immediately; they are mutually exclusive.

Parameter	Type	Description
`social_accounts`req	number[]	Account ids to publish to.
`caption`	string	Shared caption. Per-platform overrides win where set.
`media`	string[]	Media ids from the upload flow.
`media_urls`	string[]	Public URLs, downloaded server-side.
`scheduled_at`	ISO 8601	Future timestamp. Timezone priority: explicit > profile > UTC.
`use_queue`	boolean	Drop into the next free queue slot instead of a fixed time.
`is_draft`	boolean	Save without scheduling.
`platform_configurations`	object	Per-platform options, keyed by platform id.
`account_configurations`	object[]	Per-account overrides, keyed by account_id.

Request body

{
  "caption": "shipping day 🚂 #buildinpublic",
  "media_urls": ["https://cdn.example.com/launch.mp4"],
  "social_accounts": [1, 2, 3],
  "scheduled_at": "2026-09-01T14:00:00Z",
  "platform_configurations": {
    "tiktok":    { "draft": true, "video_cover_timestamp_ms": 3000, "is_aigc": true },
    "instagram": { "is_trial_reel": true, "trial_graduation": "SS_PERFORMANCE" },
    "youtube":   { "title": "My Short Title" },
    "pinterest": { "title": "Pin Title", "link": "https://…", "board_ids": ["b1"] }
  },
  "account_configurations": [
    { "account_id": 1, "caption": "a different caption for this one account" }
  ]
}

Response

201 → { "id": "uuid", "status": "scheduled", "scheduled_at": "2026-09-01T14:00:00Z", … }

GET/v1/posts

List posts, newest first.

Parameter	Type	Description
`status`	string	scheduled · published · failed · draft
`platform`	string	Filter to one platform, e.g. instagram.
`limit`	integer	Default 50.
`offset`	integer	Default 0.

GET/v1/posts/{post_id}

Full post detail, including per-platform configuration.

PATCH/v1/posts/{post_id}

Update a scheduled or draft post. Only the fields you send change. Published posts are immutable.

DELETE/v1/posts/{post_id}

Delete a scheduled or draft post. Published posts cannot be deleted.