Get run status
GET
/api/agent/runs/{id}Authorization
AuthorizationBearer token (ba_sk_...) · headerrequiredAPI key from /dashboard/api-keys. Keys expire after 365 days.
or
AuthorizationBearer token (ba_mcp_access_...) · headerrequiredThe 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
idstringrequiredRun id
Query parameters
executor_idstringrequiredResponses
200
OK
runobject401
Missing, invalid, expired, or revoked API key
errorstringrequiredcodestring