BrainyShorts API

BrainyShorts is a free social publishing control plane. 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.

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).

Accounts

Connected social accounts

• GET
  List connected accounts/api/cli/accounts

Posts

Create, schedule, update, and delete social posts

• GET
  List posts/api/cli/posts
• POST
  Create a post/api/cli/posts
• DELETE
  Delete a post delivery/api/cli/posts
• PATCH
  Update or unschedule a post/api/cli/posts

Bulk

Idempotent batches of up to 100 drafts or schedules

• GET
  Inspect a batch/api/cli/posts/bulk
• POST
  Create up to 100 drafts or schedules/api/cli/posts/bulk
• PATCH
  Update up to 100 scheduled posts/api/cli/posts/bulk

Media

Upload finished media to managed storage

• POST
  Reserve a managed media upload/api/cli/media/uploads
• PATCH
  Mark an upload complete/api/cli/media/uploads

Articles

Long-form articles for DEV.to, Hashnode, Reddit, LinkedIn, and X

• GET
  List articles/api/cli/articles
• POST
  Create, schedule, or publish an article/api/cli/articles
• DELETE
  Delete an article/api/cli/articles

Analytics

Owner-scoped performance metrics

• GET
  Get analytics/api/cli/analytics

Skills

Public, versioned instruction skills. No auth.

• GET
  List skills/api/skills
• GET
  Get a skill/api/skills/{id}

Automations

Scheduled agent runs and the runner protocol

• GET
  List automations/api/automations
• POST
  Register or update an executor/api/agent/executors
• GET
  Sync automations for an executor/api/agent/automations/sync
• POST
  Acknowledge an applied revision/api/agent/automations/{id}/ack
• POST
  Start a run/api/agent/automations/{id}/start
• GET
  Get run status/api/agent/runs/{id}
• POST
  Record a run step/api/agent/runs/{id}/events
• POST
  Reserve a media upload for a run/api/agent/runs/{id}/media/uploads
• PATCH
  Complete a run media upload/api/agent/runs/{id}/media/uploads
• POST
  Open a TikTok or YouTube direct upload/api/agent/runs/{id}/direct-upload
• POST
  Check a direct upload/api/agent/runs/{id}/direct-upload/status
• POST
  Complete a local run/api/agent/runs/{id}/complete-local
• POST
  Fail a run/api/agent/runs/{id}/fail
• POST
  Claim a queued run (legacy queue)/api/agent/runs/claim
• POST
  Renew a claim (legacy queue)/api/agent/runs/{id}/renew
• POST
  Complete a claimed run (legacy queue)/api/agent/runs/{id}/complete
• POST
  Skip a claimed run (legacy queue)/api/agent/runs/{id}/skip