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

ListBuildsOutputBody

object

dataarray[object] or nullrequired
- created_atobjectrequired
- digeststring or nullrequired
- errordictionary[string, any]required
- finished_atobjectrequired
- idstringrequired
- imagestring or nullrequired
- namestringrequired
- objectstringrequired
- started_atobjectrequired
- statusstringrequired
has_morebooleanrequired
next_cursorstring or nullrequired
objectstringrequired
Example: "list"

Example

{
  "data": [
    {
      "created_at": {},
      "digest": "string",
      "error": {
        "property1": null,
        "property2": null
      },
      "finished_at": {},
      "id": "string",
      "image": "string",
      "name": "string",
      "object": "string",
      "started_at": {},
      "status": "string"
    }
  ],
  "has_more": true,
  "next_cursor": "string",
  "object": "list"
}