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

Delete a post delivery

Takes a delivery id (the id from GET /posts, not the parent post_id). Only draft, scheduled, retry_scheduled, or failed deliveries can be deleted; anything else returns 409.

DELETE/api/cli/posts
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.

Request body
requiredapplication/json
idstringrequired
Responses
200

OK

successboolean
401

Missing, invalid, expired, or revoked API key

errorstringrequired
codestring
404

Not found

errorstringrequired
codestring
409

Post is not deletable in its current status

errorstringrequired
codestring
Try it
Server
Authorization
Bodyapplication/json
Request
curl -X DELETE "https://www.brainyshorts.com/api/cli/posts" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "string"
}'
Response
{
  "success": true
}