Skip to main content

Delete post

DELETE 
/posts/:id

Permanently delete a scheduled or draft post. Published posts cannot be deleted (platforms must be managed from within their own UIs). This action cannot be undone.

What "delete" means here

Deleting a post removes the record from your PostEverywhere workspace and cancels all pending destinations. It does not retract posts that have already been published to platforms — those remain live on X, Instagram, etc., and must be removed directly from those platforms.

Path Parameters​

ParameterTypeRequiredDescription
post_idstring (UUID)YesUUID of the post to delete. Accepts id as a deprecated alias in the URL path.

Response Example​

200 — Post deleted​

{
  "data": {
    "post_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "deleted": true
  },
  "error": null,
  "meta": {
    "request_id": "a1b2c3d4",
    "timestamp": "2026-04-12T08:30:00.000Z"
  }
}

404 — Post not found​

{
  "data": null,
  "error": {
    "message": "Post not found.",
    "code": "not_found"
  },
  "meta": {
    "request_id": "e5f6g7h8",
    "timestamp": "2026-04-12T08:30:00.000Z"
  }
}

409 — Cannot delete a published post​

{
  "data": null,
  "error": {
    "message": "Cannot delete a post that has already been published. Delete it from the platform directly.",
    "code": "post_already_published"
  },
  "meta": {
    "request_id": "i9j0k1l2",
    "timestamp": "2026-04-12T08:30:00.000Z"
  }
}

Request​

Responses​

Post deleted