Browse the docs

Cancel post

Cancels a scheduled post so it never goes out. Posts that have started publishing cannot be cancelled.

Or open inClaude Code Codex Cursor Claude ChatGPT

Paste it into any AI assistant. The shortcuts open with the prompt typed in; nothing is sent until you press enter.

At a glance

Property	Value
REST	`DELETE https://api.clippie.ai/v1/social/posts/:id`
MCP tool	`cancel_post`
Scope	`publish`
Cost	Spends nothing. Needs the `publish` scope and a paid plan, and posts under the user's name: confirm the details with them first.

REST
DELETE https://api.clippie.ai/v1/social/posts/:id
MCP tool
cancel_post
Scope
publish
Cost
Spends nothing. Needs the publish scope and a paid plan, and posts under the user's name: confirm the details with them first.

Parameters

Name	In	Type	Required	Default	Description
`id`	path	string	Yes		The post id from post_video or list_posts. 1-64 chars.

id
In:
path
Type:
string
Required:
Yes
Description:
The post id from post_video or list_posts. 1-64 chars.

Example

curl

curl "https://api.clippie.ai/v1/social/posts/ID" \
  -H "Authorization: Bearer $CLIPPIE_API_KEY"

cancel-post.mjs

const auth = { Authorization: `Bearer ${process.env.CLIPPIE_API_KEY}` };

const res = await fetch('https://api.clippie.ai/v1/social/posts/ID', { headers: auth });
if (!res.ok) throw new Error((await res.json()).error.message);
console.log(await res.json());

Response

200 with JSON. The full response schema is in the OpenAPI spec.

From an MCP client

Your AI calls cancel_post with the same fields as JSON arguments. See MCP server to connect one.

tools/call

{
  "name": "cancel_post",
  "arguments": {
    "id": "ID"
  }
}