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

SecretView

object

created_atobjectrequired
idstringrequired
last_injected_atobjectrequired
max_ttl_sinteger<int64>required
namestringrequired
objectstringrequired
project_idstringrequired
rotationdictionary[string, any]required
tiersarray[integer<int64>] or nullrequired
updated_atobjectrequired
versioninteger<int64>required

Example

{
  "created_at": {},
  "id": "string",
  "last_injected_at": {},
  "max_ttl_s": 0,
  "name": "string",
  "object": "string",
  "project_id": "string",
  "rotation": {
    "property1": null,
    "property2": null
  },
  "tiers": [
    0
  ],
  "updated_at": {},
  "version": 0
}