Skip to content
BrainyShorts Docs
Esc
↑↓navigate↵open⌘Jpreview

Delete a post delivery

Same operation as DELETE /api/cli/posts, with the delivery id in the path. Only draft, scheduled, retry_scheduled, or failed deliveries can be deleted. MCP: brainy_delete_post.

DELETE/api/cli/posts/{id}
Authorization
AuthorizationBearer token (ba_sk_...) · headerrequired

API key from /dashboard/api-keys. Keys expire after 365 days.

or
AuthorizationBearer token (ba_mcp_access_...) · headerrequired

The OAuth access token the hosted MCP server issues (brainy:read for GET routes, brainy:write for everything else). One login serves MCP, the CLI and the desktop app. A token without the needed scope gets 403 Insufficient scope.

Path parameters
idstring<uuid>required
Responses
200

OK

successboolean
idstring
400

id is not a UUID

errorstringrequired
codestring
401

Missing, invalid, expired, or revoked API key

errorstringrequired
codestring
404

Not found

errorstringrequired
codestring
409

POST_NOT_DELETABLE: the delivery is already posted or publishing

errorstringrequired
codestring
Try it
Server
Authorization
Parameters
Request
curl -X DELETE "https://www.brainyshorts.com/api/cli/posts/497f6eca-6276-4993-bfeb-53cbbbba6f08" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "success": true,
  "id": "string"
}