Create up to 100 drafts or schedules
Idempotent per batch_id + item_key: retry an identical request after a timeout. Changing an item while keeping its key is a conflict. Bulk cannot publish immediately. Media must be managed uploads referenced by asset_id.
/api/cli/posts/bulkAuthorizationBearer token (ba_sk_...) · headerrequiredAPI key from /dashboard/api-keys. Keys expire after 365 days.
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.
application/jsonbatch_idstring<uuid>requireditemsobject[]requiredShow propertiesHide properties
objectitem_keystringrequiredtitlestringrequiredcaptionstringrequiredmedia_typestringrequiredimagecarouselvideomediaobject[]requiredShow propertiesHide properties
objectasset_idstring<uuid>requiredtextstringaspect_ratiostringtargetsTarget[]Show propertiesHide properties
Targetsocial_account_idstring<uuid>requiredplatformPlatformrequiredtiktokinstagramyoutubelinkedinxsettingsobjectactionstringrequireddraftschedulescheduled_atstring<date-time>cover_msintegerVideo items only. Cover frame in milliseconds, as cover_ms on single posts.
cover_asset_idstring<uuid>Video items only. Asset id of a completed JPEG or PNG upload used as the cover, as cover_url on single posts.
Created
batch_idstring<uuid>itemsobject[]totalintegerhas_morebooleanwarningsstring[]nextstringInvalid batch
errorstringrequiredcodestringMissing, invalid, expired, or revoked API key
errorstringrequiredcodestringMonthly 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
planstringIdempotency conflict
errorstringrequiredcodestring