Cancel a scheduled post | BetterPost Docs

Stop a scheduled post from publishing and keep it as a draft, with credits refunded.

curl -s -X DELETE https://api.betterpost.dev/v1/posts/scheduled/post_8f3k2m9q1x7v4n6b0c5d2a1z \
  -H "x-access-key: $BETTERPOST_API_KEY"

{ "success": true, "message": "Post cancelled and moved to draft." }

The post is not deleted: it becomes a draft with no scheduled time, and its credits are refunded. Publish or schedule it again later with edit. To remove it entirely, delete it instead. A post that is not scheduled returns 409 not_scheduled.

Cancelling a scheduled retry of a post that already published on some platforms keeps those platforms: the retried platforms go back to failed (refunded) and the post stays partial, so you can retry it again later.

Reference: DELETE /v1/posts/scheduled/{id}.

curl -s -X DELETE https://api.betterpost.dev/v1/posts/scheduled/post_8f3k2m9q1x7v4n6b0c5d2a1z \
  -H "x-access-key: $BETTERPOST_API_KEY"

{ "success": true, "message": "Post cancelled and moved to draft." }

Reference: DELETE /v1/posts/scheduled/{id}.