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

List articles

GET/api/cli/articles
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
Allowed:draftpublishingpublishedfailed
limitinteger
min 1 · max 100 · default: 50
Responses
200

OK

articlesobject[]
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/articles" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "articles": [
    {}
  ]
}