---
title: "Delete & cancel a post"
method: DELETE
path: "/v1/posts/{id}"
tags: ["Posts"]
---

# Delete & cancel a post

`DELETE /v1/posts/{id}`

## Request

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

Cancel a scheduled post by removing it from the publishing queue and deleting it from the database. If the post is scheduled (not yet published), the publishing task is cancelled first, then the post record is removed. If the post was already published, it is only deleted from the Outstand database - the published content remains on the social media platforms. This action cannot be undone.

## Path parameters

- `id` string, required

## Response `200`

Post cancelled from publishing queue and deleted successfully

- object: Successful post cancellation response
  - `success` boolean, required: Whether the post cancellation was successful
  - `message` string, required: Success message

## Other responses

- `403`: Unauthorized - post does not belong to your organization. Activity will be recorded.
- `404`: Post not found. Potential reason: post was already deleted.
- `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)