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

Update up to 100 scheduled posts

Each update is applied independently; the response reports per-item results. Entries take a parent post_id plus caption, scheduled_at, or add_targets. There is no status field: to return a post to draft, use PATCH /api/cli/posts with status: "draft".

PATCH/api/cli/posts/bulk
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
updatesobject[]required
min items 1 · max items 100
Show properties
Array of object
post_idstringrequired
captionstring
max length 2200
scheduled_atstring<date-time>
add_targetsTarget[]
max items 12
Show properties
Array of Target
social_account_idstring<uuid>required
platformPlatformrequired
Allowed:tiktokinstagramyoutubelinkedinx
settingsobject
Responses
200

OK

totalinteger
updated_countinteger
failed_countinteger
resultsobject[]
nextstring
401

Missing, invalid, expired, or revoked API key

errorstringrequired
codestring
Try it
Server
Authorization
Bodyapplication/json
Request
curl -X PATCH "https://www.brainyshorts.com/api/cli/posts/bulk" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": [
    {
      "post_id": "string",
      "caption": "string",
      "scheduled_at": "2019-08-24T14:15:22Z",
      "add_targets": [
        {
          "social_account_id": "f4777757-36aa-48ee-b520-6e818e68eb51",
          "platform": "tiktok",
          "settings": {}
        }
      ]
    }
  ]
}'
Response
{
  "total": 0,
  "updated_count": 0,
  "failed_count": 0,
  "results": [
    {}
  ],
  "next": "string"
}