REST API

Automate the platform programmatically.

Base URL & auth

All requests go to https://api.robinclaw.cloud and require a bearer token. Generate one from your workspace Secrets.

Authentication

Authorization: Bearer $ROBINCLAW_TOKEN
Content-Type: application/json

Requests are scoped to your workspace and enforced by row-level security. You only ever see your own resources.

GET	/v1/os	List Operating Systems
POST	/v1/os	Create an Operating System
GET	/v1/os/{id}	Retrieve an Operating System
PATCH	/v1/os/{id}	Update status or name
DELETE	/v1/os/{id}	Terminate an Operating System
POST	/v1/os/{id}/clone	Clone an Operating System
GET	/v1/os/{id}/agents	List agents
PATCH	/v1/os/{id}/agents/{agentId}	Update an agent
GET	/v1/os/{id}/portfolio	Portfolio snapshot
GET	/v1/os/{id}/automations	List automations
POST	/v1/os/{id}/automations/{id}/run	Run an automation
GET	/v1/account	Usage & billing

POST /v1/os

{
  "name": "Research Lab",
  "region": "us-west",
  "personality": "research-analyst",
  "capabilities": ["research", "risk", "portfolio"]
}

201 Created

{
  "id": "os_research-lab_a1b2",
  "status": "running",
  "region": "us-west",
  "agentCount": 3,
  "createdAt": "2026-07-12T09:14:00Z"
}