List posts
Each row is one platform delivery, flattened for convenience. id is the delivery id and post_id is the parent post id. PATCH accepts either id; DELETE takes a delivery id only. Newest first, at most 100 rows. Neither id is the post_id that analytics returns.
GET
/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.
Query parameters
statusstringplatformPlatformAllowed:
tiktokinstagramyoutubelinkedinxlimitintegermin 1 · max 100 · default: 50
Responses
200
OK
postsPostDelivery[]Show propertiesHide properties
Array of
PostDeliveryidstringDelivery id
post_idstringParent post id
platformPlatformAllowed:
tiktokinstagramyoutubelinkedinxstatusstringscheduled_timestring<date-time> | nullposted_timestring<date-time> | nulllast_errorstring | nullaccountstring | nullAccount handle
titlestringcaptionstringmedia_typestringmedia_urlsstring[]video_urlstring | nullsocial_account_idstring<uuid> | nullplatform_post_idstring | nullThe platform's own id once posted
platform_urlstring | null401
Missing, invalid, expired, or revoked API key
errorstringrequiredcodestring