Refresh analytics from the platforms
Pulls fresh metrics and follower counts for the owner’s connected accounts before reading GET /api/cli/analytics or GET /api/cli/accounts/overview. Same guards as the dashboard refresh: at most 5 accounts per call, and each account syncs at most once every 5 minutes. Accounts inside that window are skipped and counted in skipped, so calling again is safe. MCP: brainy_refresh_analytics.
/api/cli/analytics/refreshAuthorizationBearer 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/jsonaccount_idsstring<uuid>[]Omit to refresh every refreshable account.
platformstring | nullinstagramtiktokyoutubelinkedinxnullOK. refreshed may be 0 when every account is inside its cooldown.
successbooleanmessagestringrefreshedintegerfailedintegerskippedintegerretryAfterSecondsintegerInvalid request, or more than 5 accounts selected
errorstringrequiredcodestringMissing, invalid, expired, or revoked API key
errorstringrequiredcodestringNo refreshable account matches
errorstringrequiredcodestringLINKEDIN_ANALYTICS_PERMISSION_REQUIRED: the user must connect LinkedIn analytics
errorstringrequiredcodestringEvery attempted refresh failed; code says why (for example a reconnect is required)
errorstringrequiredcodestring