Skip to content
BrainyShorts Docs
Esc
↑↓navigate↵open⌘Jpreview

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/posts
Authorization
AuthorizationBearer token (ba_sk_...) · headerrequired

API key from /dashboard/api-keys. Keys expire after 365 days.

or
AuthorizationBearer token (ba_mcp_access_...) · headerrequired

The 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
statusstring
platformPlatform
Allowed:tiktokinstagramyoutubelinkedinx
limitinteger
min 1 · max 100 · default: 50
Responses
200

OK

postsPostDelivery[]
Show properties
Array of PostDelivery
idstring

Delivery id

post_idstring

Parent post id

platformPlatform
Allowed:tiktokinstagramyoutubelinkedinx
statusstring
scheduled_timestring<date-time> | null
posted_timestring<date-time> | null
last_errorstring | null
accountstring | null

Account handle

titlestring
captionstring
media_typestring
media_urlsstring[]
video_urlstring | null
social_account_idstring<uuid> | null
platform_post_idstring | null

The platform's own id once posted

platform_urlstring | null
401

Missing, invalid, expired, or revoked API key

errorstringrequired
codestring
Try it
Server
Authorization
Parameters
Request
curl -X GET "https://www.brainyshorts.com/api/cli/posts" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "posts": [
    {
      "id": "string",
      "post_id": "string",
      "platform": "tiktok",
      "status": "string",
      "scheduled_time": "2019-08-24T14:15:22Z",
      "posted_time": "2019-08-24T14:15:22Z",
      "last_error": "string",
      "account": "string",
      "title": "string",
      "caption": "string",
      "media_type": "string",
      "media_urls": [
        "string"
      ],
      "video_url": "string",
      "social_account_id": "f4777757-36aa-48ee-b520-6e818e68eb51",
      "platform_post_id": "string",
      "platform_url": "string"
    }
  ]
}