# Delete a post

> Delete a post from Postprism.

**Source:** https://postprism.app/docs/api/delete-post  
**Updated:** 2026-10-10

---

`DELETE https://studio.postprism.app/api/v1/posts/{id}`

Deletes the post from Postprism, so a scheduled post will not publish. It does not remove anything already published on a social network.

Returns `204 No Content` with an empty body.

## Parameters

| Name | In | Type | Description |
| --- | --- | --- | --- |
| `id` | path | uuid, required | The post ID. |
| `workspace_id` | query | uuid | Act on another workspace you belong to. Defaults to the workspace your API key was created in. |

## Example

```bash
curl -X DELETE "https://studio.postprism.app/api/v1/posts/3f1c2a9e-0000-4000-8000-00000000a001" \
  -H "Authorization: Bearer pp_live_your_api_key"
```

## Response

Status `204`.

## Errors

| Status | Message | When |
| --- | --- | --- |
| 401 | `Invalid or revoked API key` | The `Authorization` header is missing, malformed, or the key was revoked. |
| 404 | `Workspace not found, or you are not a member of it.` | The `workspace_id` you passed (or your key’s default workspace) is not one you belong to. |
| 429 | `Too many requests` | You went over the hourly limit. See Rate limits. |
| 500 | `Failed to delete post.` | The post could not be deleted. Try again. |