API
Brainbase Managed Agents Service
Templates
Create Template
POST /v2/agents/templates
List Templates
GET /v2/agents/templates
Get Template
GET /v2/agents/templates/{creator}/{slug}
Update Template
PATCH /v2/agents/templates/{creator}/{slug}
Delete Template
DELETE /v2/agents/templates/{creator}/{slug}
Agents
Create Agent
POST /v2/agents
List Agents
GET /v2/agents
Get Agent
GET /v2/agents/{agent_id}
Update Agent
PATCH /v2/agents/{agent_id}
Delete Agent
DELETE /v2/agents/{agent_id}
Orchestration Templates
Create Orchestration Template
POST /v2/orchestrations/templates
List Orchestration Templates
GET /v2/orchestrations/templates
Get Orchestration Template
GET /v2/orchestrations/templates/{creator}/{slug}
Update Orchestration Template
PATCH /v2/orchestrations/templates/{creator}/{slug}
Delete Orchestration Template
DELETE /v2/orchestrations/templates/{creator}/{slug}
Orchestrations
Create Orchestration
POST /v2/orchestrations
List Orchestrations
List orchestrations under a single group. ``group_id`` is required
Get Orchestration
GET /v2/orchestrations/{orchestration_id}
Update Orchestration
PATCH /v2/orchestrations/{orchestration_id}
Delete Orchestration
DELETE /v2/orchestrations/{orchestration_id}
Scope
Tasks
Create Task
POST /v2/tasks
List Tasks
GET /v2/tasks
Get Task
GET /v2/tasks/{task_id}
Update Task
PATCH /v2/tasks/{task_id}
Delete Task
DELETE /v2/tasks/{task_id}
Interrupt Task
POST /v2/tasks/{task_id}/interrupt
Machines
Create Machine
POST /v2/machines
List Machines
GET /v2/machines
Get Machine
GET /v2/machines/{machine_id}
Delete Machine
Terminal teardown: destroy the provider sandbox and mark the row DEAD.
Machine Status
GET /v2/machines/{machine_id}/status
Machine Preview
Return a preview link to ``port`` on the machine.
Messages
Events
Files
List Files
GET /v2/tasks/{task_id}/files
Delete File
DELETE /v2/tasks/{task_id}/files
File Tree
GET /v2/tasks/{task_id}/files/tree
Stat File
GET /v2/tasks/{task_id}/files/stat
Download File
GET /v2/tasks/{task_id}/files/download
Upload File
POST /v2/tasks/{task_id}/files/upload
Create Folder
POST /v2/tasks/{task_id}/files/folders
Move File
POST /v2/tasks/{task_id}/files/move
Alerts
Create Alert
Create an alert. The signing secret plaintext is returned in this
List Alerts
List alerts under a group. ``group_id`` is required — the
Get Alert
GET /v2/alerts/{alert_id}
Update Alert
PATCH /v2/alerts/{alert_id}
Delete Alert
DELETE /v2/alerts/{alert_id}
Rotate Secret
Mint a new signing secret. Old signatures stop validating
List Fires
List recent deliveries for an alert. Ordered most-recent first.
Evals
Create Eval
POST /v2/agents/{agent_id}/evals
List Evals
GET /v2/agents/{agent_id}/evals
Get Eval
GET /v2/agents/{agent_id}/evals/{eval_id}
Update Eval
PATCH /v2/agents/{agent_id}/evals/{eval_id}
Delete Eval
DELETE /v2/agents/{agent_id}/evals/{eval_id}