Unpublish a Published Post
Delete a post that was already published to a platform. This removes the live post from the target network.
Platform support
| Platform | Deletion |
|---|---|
| ✅ | |
| YouTube | ✅ |
| X | ✅ |
| ✅ | |
| ✅ | |
| Bluesky | ✅ |
| Google Business | ✅ |
| Discord | ✅ |
| Telegram | ✅ |
| Mastodon | ✅ |
| WordPress | ✅ |
| Threads | ❌ |
| ❌ | |
| TikTok | ❌ |
Instagram and TikTok do not support deletion via API. Threads returns 400 error_code: "platform_not_supported" (threads_delete is not granted). For Bluesky, post_id is the at:// URI or a bsky.app URL. For Google Business, post_id is the full accounts/{a}/locations/{l}/localPosts/{p} name returned on upload.
Endpoint
POST /api/uploadposts/posts/unpublish
Headers
| Name | Value | Description |
|---|---|---|
| Authorization | Apikey your-api-key-here | Your API key for authentication |
| Content-Type | application/json | Request body format |
Body Parameters (JSON)
| Name | Type | Required | Description |
|---|---|---|---|
platform | String | Yes | One of facebook, youtube, x, linkedin, pinterest, bluesky, google_business, plus credential channels that support delete. threads returns platform_not_supported. |
user | String | Yes | Profile username (as configured in Upload-Post). |
post_id | String | Yes | The published post's ID on the target platform. |
Example Request
curl -X POST https://api.upload-post.com/api/uploadposts/posts/unpublish \
-H 'Authorization: Apikey your-api-key-here' \
-H 'Content-Type: application/json' \
-d '{
"platform": "youtube",
"user": "my-profile",
"post_id": "dQw4w9WgXcQ"
}'
Successful Response (200 OK)
{
"success": true,
"message": "Post deleted successfully"
}
Error Responses
- 400 Bad Request — missing fields, or an unsupported platform (e.g.
instagram,tiktok,threads). - 403 Forbidden — the connected account is not authorized to delete the post.
- 404 Not Found — no post found for the given
post_id. - 500 Internal Server Error