delete_post
Delete posts. DESTRUCTIVE and IRREVERSIBLE. post_id: delete one post; fetch it with get_post first, confirm what will be deleted, then pass confirm=true. A post that is currently publishing is never deleted. A published post is taken down only when the user also explicitly confirms the live removal and you pass confirm_published=true. Choose delete_mode=posterly to remove only the posterly record and leave the live post up, or delete_mode=platform with confirm_published=true to take down the live post too. Live deletion supports eligible connected platforms with saved post IDs and deletion permissions; refusals keep the record. Threads requires threads_delete. YouTube requires youtube.force-ssl or equivalent, upload alone is insufficient. A published post with no live URL and no platform id is removed from posterly only. group_id: delete every draft, scheduled, failed, or paused post matching a caller-defined group_id, post_group_id, api_group_id, or release_id. A group delete never removes published posts. Preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | post_id: true after the user explicitly confirms the deletion. group_id: Leave out to get a preview and preview_id. Set true only after the user explicitly approved the preview, together with preview_id. | |
| post_id | No | Delete this one post. | |
| group_id | No | Delete every unpublished post in this group or release instead. Never deletes published posts. | |
| preview_id | No | The preview_id from the preview call. Required with confirm: true for actions that preview first. | |
| delete_mode | No | Remove the posterly record only, or also take down the live post. | |
| confirm_published | No | With post_id only. True only after the user explicitly confirms taking a live post down. Required with delete_mode=platform. Use delete_mode=posterly to leave the live post up. |