---
title: "Cancel Scheduled Post"
method: DELETE
path: "/api/v1/scheduled-posts/{post_id}"
tags: ["Social"]
---

# Cancel Scheduled Post

`DELETE /api/v1/scheduled-posts/{post_id}`

## Request

- Base URL: `https://api.clipmaster.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.clipmaster.app/api/v1/scheduled-posts/{post_id}`
- Auth: HTTP bearer

Cancel a pending post, or remove a finished one from the calendar.
Deliberately NOT premium-gated: users whose plan lapsed must still be
able to stop queued publishes.

Pending posts are canceled (kept as history); terminal posts are
hard-deleted — record-only, the published platform video is never touched.
Only `publishing` refuses: the upload may be in flight.

## Path parameters

- `post_id` integer, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent.md) · [All operations](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent/llms.txt) · [OpenAPI document](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent/revisions/c9b8333cd22b?raw)