delete_post

Cancel and remove a scheduled or pending post. Cannot delete already published posts. Same as update_post with status "cancelled".

Parameters

When to use

Soft-delete a post from Postato. Works on any non-terminal state (draft, scheduled, queued, pending_approval). Published posts cannot be deleted via Postato — they live on the social network and must be removed there directly.

Soft-delete means:

• The post disappears from list_posts and the dashboard.
• If it was scheduled, the pending job is cancelled.
• If it was awaiting approval, reviewers can no longer act on it.
• The underlying record is retained for audit and compliance — it is never hard-deleted.

Example

{
  "workspaceId": "wks_01H...",
  "postId": "pst_01H..."
}

Response: { "success": true } (or 404 if the post doesn't exist in this workspace).

Gotchas

• This is NOT how you delete a published post from X / Instagram / LinkedIn. Use the platform's native tooling or API for that.
• Once deleted, the post cannot be restored via the API. Contact support if a mistaken deletion needs recovering.
• Deleting a scheduled post with an assigned idempotencyKey does NOT free that key — subsequent publish_post calls with the same key will still hit the idempotency record. Use a fresh key to republish.