API reference
Stop a scheduled post from publishing; it becomes a draft and its credits are refunded.
https://api.betterpost.dev/v1/posts/scheduled/{id}The post is kept as a draft with no scheduled time. Charged targets that had not published are refunded.
A scheduled retry of a post with published targets is not turned into a draft: its unpublished targets become
failed (refunded), the published ones are untouched, and the post status returns to partial. The message is
then "Scheduled retry cancelled; the post keeps its published platforms."
| Name | Description |
|---|---|
id | The post id. The post must be scheduled. |
curl -s -X DELETE https://api.betterpost.dev/v1/posts/scheduled/post_8f3k2m9q1x7v4n6b0c5d2a1z \
-H "x-access-key: $BETTERPOST_API_KEY"200 OK
{ "success": true, "message": "Post cancelled and moved to draft." }| Status | Code | When |
|---|---|---|
200 | The post was cancelled and is now a draft. | |
401 | unauthorized | Missing or unknown API key. |
404 | not_found | No such post in this project. |
409 | not_scheduled | The post is not scheduled. |
429 | rate_limited | More than 120 requests per minute. |