Register or update an executor
An executor is the machine and agent that runs local automations. Pass executor_id to update an existing one.
POST
/api/agent/executorsAuthorization
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
requiredapplication/jsonexecutor_idstringnamestringrequiredmax length 100
agent_typestringrequiredmax length 50
device_labelstringcapabilitiesobjectResponses
200
OK
executorobject401
Missing, invalid, expired, or revoked API key
errorstringrequiredcodestring404
EXECUTOR_NOT_FOUND
errorstringrequiredcodestring