Change post status
PUT /public/v1/posts/{id}/statusPromotes 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.
Path parameters
Section titled “Path parameters”| Parameter | Required | Description |
|---|---|---|
id |
Yes | The post id. |
| Field | Required | Description |
|---|---|---|
status |
Yes | draft or schedule. Any other value is a 400. |
Request
Section titled “Request”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" }'Response
Section titled “Response”{ "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
publishDateis already in the past, promoting it toschedulepublishes 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 futuredate, or move it on the calendar in the app first. - A post id that is not in your organization returns
400withPost not found.