---
title: "Delete a post from social networks"
method: DELETE
path: "/v1/posts/{id}/remote"
tags: ["Posts"]
---

# Delete a post from social networks

`DELETE /v1/posts/{id}/remote`

## Request

- Base URL: `https://api.outstand.so`
- URL: `https://api.outstand.so/v1/posts/{id}/remote`
- Auth: none declared

Delete a published post from all remote social network platforms it was published to. The post record is kept in the Outstand database but marked as deleted. Returns per-account results - networks that do not support post deletion via API (TikTok, Instagram) will appear with status='failed'. Threads is supported (requires the threads_delete scope) and only removes posts created by the connected account. At least one successful deletion returns HTTP 200 with success=true.

## Path parameters

- `id` string, required

## Response `200`

Remote deletion attempted. Check the 'results' array for per-account status. 'success' is true if at least one network deleted the post.

- object
  - `success` boolean, required: True if at least one social network account had its post successfully deleted. False if all accounts failed.
  - `results` object[], required: Per-account deletion results. Networks without a delete API (TikTok, Instagram, Threads) will appear here with status='failed'.
    - `network` string, required: Social network identifier (e.g., 'x', 'linkedin', 'bluesky')
    - `username` string, required: Username or handle on the social network
    - `platform_post_id` string, nullable, required: The platform-specific post ID that was targeted for deletion
    - `status` 'deleted' | 'failed', required: 'deleted': post was successfully removed from the platform and its status is marked deleted. 'failed': deletion failed or the network does not support deleting posts via API (see error field).
    - `error` string, nullable, required: Error message when status is 'failed'. Examples: 'TikTok does not support deleting posts via API', 'X API error 403: Forbidden'.

## Other responses

- `400`: Post has not been published to any social network yet.
- `403`: Unauthorized - post does not belong to your organization.
- `404`: Post not found.
- `500`: Internal server error.

---

[API](https://skmtc.dev/outstand/apis/outstand-posts-v1.md) · [All operations](https://skmtc.dev/outstand/apis/outstand-posts-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/outstand/apis/outstand-posts-v1/revisions/9cf3d8976019?raw)