Posts

Method	Path	Description
GET	/posts	List (?status=DRAFT|SCHEDULED|PUBLISHED|FAILED)
GET	/posts/:id	Get one
POST	/posts	Create
POST	/posts/:id/schedule	{ "scheduledAt": "ISO" }
PATCH	/posts/:id/status	{ "status": "draft" | "schedule" }
DELETE	/posts/:id	Delete

Create — type

Value	Behavior
draft	Saved only
schedule	Requires date (UTC ISO)
now	Queued immediately for the worker

Shorthand body

{
  "type": "schedule",
  "date": "2026-09-20T10:00:00.000Z",
  "content": "Hello from QPosty",
  "channelIds": ["clx_channel_id"],
  "mediaIds": ["clx_media_id"]
}

Per-channel body

{
  "type": "now",
  "posts": [
    {
      "channelId": "clx_channel_id",
      "content": "Hello Instagram",
      "mediaIds": ["clx_media_id"],
      "settings": { "__type": "instagram" }
    }
  ]
}

Identical captions across items are merged into one post with multiple targets.

Provider settings details: Provider settings.