Update or unschedule a post
Accepts a delivery id or a parent post id. Every still-scheduled delivery under the parent is updated together. status: "draft" cancels the schedule.
PATCH
/api/cli/postsAuthorization
AuthorizationBearer token (ba_sk_...) · headerrequiredAPI key from /dashboard/api-keys. Keys expire after 365 days.
or
AuthorizationBearer token (ba_mcp_access_...) · headerrequiredThe 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/jsonidstringrequiredDelivery id or parent post id
statusstringAllowed:
draftscheduledcaptionstringmax length 2200
scheduled_atstring<date-time>Must be in the future. scheduled_time is accepted as an alias.
add_targetsTarget[]max items 12
Show propertiesHide properties
Array of
Targetsocial_account_idstring<uuid>requiredplatformPlatformrequiredAllowed:
tiktokinstagramyoutubelinkedinxsettingsobjectResponses
200
OK
post_idstringsocial_postsobject[]400
INVALID_POST_UPDATE
errorstringrequiredcodestring401
Missing, invalid, expired, or revoked API key
errorstringrequiredcodestring402
Monthly post allowance used up. Save as a draft, schedule for a later month, or upgrade at upgrade_url.
errorstringrequiredcodestringrequiredupgrade_urlstring<uri>requiredlimitintegerusedintegerrequestedintegerperiodstringUTC month, YYYY-MM
planstring404
Not found
errorstringrequiredcodestring