Claim a queued run (legacy queue)
Atomically claims one pending run. {"run": null} means no work. The legacy queue publishes to Instagram only; new integrations should use local automations.
POST
/api/agent/runs/claimAuthorization
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.
Request body
application/jsonautomation_idstringlease_secondsintegermin 60 · max 3600 · default: 900
Responses
200
OK
runobject | null401
Missing, invalid, expired, or revoked API key
errorstringrequiredcodestring