---
title: Delete a Scheduled Post - Remove Scheduled Content
description: Delete a scheduled post and all of its related content with the PostNitro Embed API. Remove planned social posts from your content calendar.
canonical: https://postnitro.ai/docs/embed/api/schedule/delete-scheduled-post
---

# Delete a scheduled post

```
DELETE /schedule/:id
```

Deletes a scheduled post and all of its related rows (content rows and account
rows) from the workspace attached to your API key.

## Authentication

`embed-api-key: <YOUR_EMBED_API_KEY>` header required. See [auth](https://postnitro.ai/docs/embed/api/schedule#authentication).

## Path parameters

| Param | Required | Description |
| --- | --- | --- |
| `id` | yes | Scheduled post id |

## Example request

```bash
curl -X DELETE "https://embed-api.postnitro.ai/schedule/post_123" \
  -H "embed-api-key: $EMBED_API_KEY"
```

## Response `200`

```jsonc
{
  "success": true,
  "message": "Scheduled post deleted",
  "data": { "message": "Post deleted successfully" }
}
```

## Errors

| Status | Body | When |
| --- | --- | --- |
| `401` / `402` | see [auth](https://postnitro.ai/docs/embed/api/schedule#authentication) | Auth / plan failure |
| `422` | `{ "status": false, "message": "Post id is required" }` | `id` missing |
| `404` | `{ "success": false, "message": "Post details not found.", "error": ... }` | No matching post in your workspace |
| upstream | `{ "success": false, "message": "Error deleting post", "error": ... }` | DB delete failed |