Docs / API / Publish a post

Publish a post

Send a post to its channels now — and be told which ones it skipped, and why.

3 min read Paid plans

POST /api/v1/posts/{id}/publish

Sends every channel that can go out. Publishing runs in the background, so this answers 202 — read the post back for the result, or subscribe to webhooks.

START HERE It names what it skipped and why. Publishing one channel while skipping another is normal, not an error — a publish that silently does nothing looks exactly like one that worked until somebody checks the network an hour later.

SKIPPED BECAUSEWHAT IT MEANSWHAT TO DO

it has not been written yet Still planned — the writer has not reached it. Wait, or check the calendar.

already published It went out before. Nothing. It is not sent twice.

not connected, or no Page or board The channel cannot publish. Connect it under Integrations.

an agent is working on it Something already has it. Try again shortly.

CAREFUL This puts the post in front of the public straight away. There is no undo — deleting the post afterwards removes it from your calendar, not from the network.

CURL

curl -X POST https://console.quqi.io/api/v1/posts/01a0585d-5755-72bd-a022-c6d6c59a7e0a/publish \
  -H "Authorization: Bearer quqi_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"website_id": "019feda8-0ca6-70d1-b927-697fa6650cda"}'

RESPONSE 202

{
  "success": true,
  "data": {
    "queued": ["linkedin"],
    "skipped": [
      {
        "channel": "x",
        "why": "that channel is not connected, or has no Page or board chosen"
      }
    ],
    "note": "Queued. Publishing runs in the background; read the post back for its result."
  }
}

Did this page answer your question? Yes Not quite

One post

Plan an article