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

Get one post

One post with every platform delivery under it: status, last_error, scheduled and posted times, platform_post_id, platform_url and analytics_post_id. id is a parent post id or a delivery id. Poll this after scheduling or publishing to see the real outcome. MCP: brainy_get_post.

GET/api/cli/posts/{id}
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.

Path parameters
idstring<uuid>required
Responses
200

OK

idstring<uuid>

Parent post id

titlestring
captionstring | null
media_typestring | null
media_urlsstring[]
statusstring

The shared status of the deliveries, or mixed when they differ (some posted, some failed or still scheduled).

scheduled_timestring<date-time> | null
posted_timestring<date-time> | null

Latest time any delivery posted

created_atstring<date-time>
deliveriesobject[]
Show properties
Array of object
idstring<uuid>

Delivery id. DELETE /api/cli/posts/{id} takes this.

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

The platform's own id once posted

platform_urlstring | null
analytics_post_idstring | null

Pass as post_id to GET /api/cli/analytics. null until an analytics sync has imported the posted video.

400

id is not a UUID

errorstringrequired
codestring
401

Missing, invalid, expired, or revoked API key

errorstringrequired
codestring
404

Not found

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