Skip to content

Change post status

PUT /public/v1/posts/{id}/status

Promotes a draft onto the calendar, or pulls a scheduled post back to a draft. The post keeps its content, its channel and its publish date; only its state changes.

This is how an approval workflow ends: create posts as drafts, review them, then flip the approved ones to schedule.

Doing this in the app? See composing and scheduling posts. Also available as sharek posts:status (CLI); the MCP server has no tool for it.

Parameter Required Description
id Yes The post id.
Field Required Description
status Yes draft or schedule. Any other value is a 400.
Terminal window
curl -X PUT https://dash.sharek.app/api/public/v1/posts/post-id/status \
-H "Authorization: your-api-key" \
-H "Content-Type: application/json" \
-d '{ "status": "schedule" }'
{ "id": "post-id", "state": "QUEUE" }

The state is the internal name for what you asked for: schedule becomes QUEUE, draft becomes DRAFT.

  • Scheduling does not move the date. If the post’s publishDate is already in the past, promoting it to schedule publishes it right away. The public API has no operation that changes a post’s date, so to publish later, delete the post and create it again with a future date, or move it on the calendar in the app first.
  • A post id that is not in your organization returns 400 with Post not found.