Workspaces.build

Start here

What is workspaces.build
Quickstart
Core concepts
Glossary

Agent tiers

Tier model
Choosing a tier
Tier 0 — Lightest compute
Tier 1 — Code agent
Tier 2 — CLI agent
Tier 3 — Browser agent
Tier 4 — Computer-use agent

Architecture

System overview
Control plane
Data plane
Isolation runtimes
Scheduler and warm pools
Session lifecycle
Networking and egress
Storage, volumes, snapshots
Multi-region
Observability

Data model

Entities
Identifiers
State machines

API

Design principles
Authentication
Errors
Pagination and idempotency
Sessions
Runs and exec
Filesystem and ports
Browser control
Desktop control
Tools and MCP
Snapshots and volumes
Usage and billing
Webhooks
Rate limits

API reference

Overview

Billing

Metering model
Rate card
Quotas and limits
End-user billing
Invoices and credits

Dashboard

Surface map
Customer console
Infra console

Security

Isolation model
Policy engine
Secrets
Compliance

Operations

SLOs
Capacity planning
Runbooks
Incident response

Reference

Roadmap
Decision log
Changelog

Docs

RunView

object

code_sha256string or nullrequired
created_atobjectrequired
duration_msinteger<int64> or nullrequired
end_user_idstring or nullrequired
errordictionary[string, any]
exit_codeinteger<int64> or nullrequired
finished_atobjectrequired
idstringrequired
imagestringrequired
kindstringrequired
labelsdictionary[string, string]required
objectstringrequired
resourcesdictionary[string, any]required
runtimestring or nullrequired
session_idstringrequired
started_atobjectrequired
statusstringrequired
stderrstringrequired
stderr_truncatedbooleanrequired
stdoutstringrequired
stdout_truncatedbooleanrequired
tierinteger<int64>required
usagedictionary[string, any]required

Example

{
  "code_sha256": "string",
  "created_at": {},
  "duration_ms": 0,
  "end_user_id": "string",
  "error": {
    "property1": null,
    "property2": null
  },
  "exit_code": 0,
  "finished_at": {},
  "id": "string",
  "image": "string",
  "kind": "string",
  "labels": {
    "property1": "string",
    "property2": "string"
  },
  "object": "string",
  "resources": {
    "property1": null,
    "property2": null
  },
  "runtime": "string",
  "session_id": "string",
  "started_at": {},
  "status": "string",
  "stderr": "string",
  "stderr_truncated": true,
  "stdout": "string",
  "stdout_truncated": true,
  "tier": 0,
  "usage": {
    "property1": null,
    "property2": null
  }
}