---
title: "Preview cancellation or published-post removal"
method: GET
path: "/v1/posts/{id}/deletion"
tags: ["Posts"]
---

# Preview cancellation or published-post removal

`GET /v1/posts/{id}/deletion`

## Request

- Base URL: `https://api.postlake.dev`
- URL: `https://api.postlake.dev/v1/posts/{id}/deletion`
- Auth: `bearerAuth` (a scheme the document does not define)

No side effects. Returns the action for the current state, destination-specific support and a full-post snapshot. Removing social posts never deletes uploads or refunds spent publishing credits. Instagram and TikTok posts must be removed in their apps. Pending publication cannot be retracted until its outcome is known. Approval requests must be rejected, not silently erased.

## Path parameters

- `id` string, required

## Response `200`

Action, canApply, snapshot, targets with canRemove/alreadyAccepted/url/reason, and effects

- PostDeletionPreview
  - `id` string, required
  - `kind` 'cancel_schedule' | 'discard_draft' | 'reject_approval' | 'remove_from_networks' | 'remove_record', required
  - `canApply` boolean, required
  - `snapshot` string, required
  - `warning` string, required
  - `targets` object[], required
    - `account` string, required
    - `platform` 'bluesky' | 'threads' | 'x' | 'linkedin' | 'instagram' | 'tiktok' | 'facebook' | 'youtube' | 'pinterest', required
    - `canRemove` boolean, required
    - `alreadyAccepted` boolean, required
    - `url` string, nullable, required
    - `reason` string, required
  - `effects` object, required
    - `deletesUploads` false, required
    - `refundsPublishingCredits` false, required

## Other responses

- `404`: Post not found in this workspace

---

[API](https://skmtc.dev/postlake/apis/postlake-api.md) · [All operations](https://skmtc.dev/postlake/apis/postlake-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postlake/apis/postlake-api/revisions/f81060e31f69?raw)