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

Get run status

GET/api/agent/runs/{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
idstringrequired

Run id

Query parameters
executor_idstringrequired
Responses
200

OK

runobject
401

Missing, invalid, expired, or revoked API key

errorstringrequired
codestring
Try it
Server
Authorization
Parameters
Request
curl -X GET "https://www.brainyshorts.com/api/agent/runs/string?executor_id=string" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "run": {}
}