BrainyShorts API
BrainyShorts is a social publishing control plane, free to start. Agents upload finished media and create, schedule, or publish posts to connected TikTok, Instagram, YouTube, LinkedIn, and X accounts, plus long-form articles to DEV.to, Hashnode, Reddit, LinkedIn, and X. BrainyShorts does not generate media.
Host: https://www.brainyshorts.com. Do not use api.brainyshorts.com; it is only a fallback alias for these REST paths.
Which surface to use. In an MCP client (Claude, ChatGPT, Cursor, Codex), use the MCP server: OAuth, no key. From a script, the brainy CLI, the desktop app, or any client without MCP, call the REST API under /api/cli/* with Authorization: Bearer ba_sk_.... The CLI and the MCP tools wrap the same operations. /api/agent/* is only for an unattended runner created through MCP automations; never use it to post. Every other /api/* path (/api/posts, /api/articles, /api/analytics, /api/media, /api/billing, /api/social, /api/api-keys, /api/automations writes) is a dashboard-session route and agents must not call it. Connecting a channel needs a human in a browser: get the connect link from brainy_get_connect_link (MCP) or POST /api/cli/accounts/connect-links (REST), give it to the user, then list accounts again until the new account appears.
Auth: send Authorization: Bearer ba_sk_.... Create keys at https://www.brainyshorts.com/dashboard/api-keys. The x-api-key header is not accepted.
MCP: the same capabilities are available as a hosted MCP server at https://www.brainyshorts.com/api/mcp (streamable HTTP, OAuth).
Plans: Free allows 30 posts a month (drafts never count). When a month is full, post creation returns 402 with code QUOTA_EXCEEDED and an upgrade_url. Check GET /api/cli/usage first.
https://www.brainyshorts.comAccounts
Connected social accounts
- GETList connected accounts
/api/cli/accounts - POSTGet a link to connect or reconnect a channel
/api/cli/accounts/connect-links - GETPer-channel overview
/api/cli/accounts/overview
Posts
Create, schedule, update, and delete social posts
- GETList posts
/api/cli/posts - POSTCreate a post
/api/cli/posts - DELETEDelete a post delivery
/api/cli/posts - PATCHUpdate or unschedule a post
/api/cli/posts - GETGet one post
/api/cli/posts/{id} - DELETEDelete a post delivery
/api/cli/posts/{id}
Bulk
Idempotent batches of up to 100 drafts or schedules
- GETInspect a batch
/api/cli/posts/bulk - POSTCreate up to 100 drafts or schedules
/api/cli/posts/bulk - PATCHUpdate up to 100 scheduled posts
/api/cli/posts/bulk
Media
Upload finished media to managed storage
- POSTReserve a managed media upload
/api/cli/media/uploads - PATCHMark an upload complete
/api/cli/media/uploads
Articles
Long-form articles for DEV.to, Hashnode, Reddit, LinkedIn, and X
- GETList articles
/api/cli/articles - POSTCreate, schedule, or publish an article
/api/cli/articles - DELETEDelete an article
/api/cli/articles
Analytics
Owner-scoped performance metrics
- GETGet analytics
/api/cli/analytics - POSTRefresh analytics from the platforms
/api/cli/analytics/refresh
Skills
Public, versioned instruction skills. No auth.
Automations
Scheduled agent runs and the runner protocol
- GETList automations
/api/automations - POSTRegister or update an executor
/api/agent/executors - GETSync automations for an executor
/api/agent/automations/sync - POSTAcknowledge an applied revision
/api/agent/automations/{id}/ack - POSTStart a run
/api/agent/automations/{id}/start - GETGet run status
/api/agent/runs/{id} - POSTRecord a run step
/api/agent/runs/{id}/events - POSTReserve a media upload for a run
/api/agent/runs/{id}/media/uploads - PATCHComplete a run media upload
/api/agent/runs/{id}/media/uploads - POSTOpen a TikTok or YouTube direct upload
/api/agent/runs/{id}/direct-upload - POSTCheck a direct upload
/api/agent/runs/{id}/direct-upload/status - POSTComplete a local run
/api/agent/runs/{id}/complete-local - POSTFail a run
/api/agent/runs/{id}/fail - POSTClaim a queued run (legacy queue)
/api/agent/runs/claim - POSTRenew a claim (legacy queue)
/api/agent/runs/{id}/renew - POSTComplete a claimed run (legacy queue)
/api/agent/runs/{id}/complete - POSTSkip a claimed run (legacy queue)
/api/agent/runs/{id}/skip
Billing
Plan, monthly usage, and checkout links for paid plans
