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

Create an additional project

POST/v1/projects

Request

Body

application/json

namestring
Shown in the console and switcher.
Example: "Staging"
slugstring
Must match ^[a-z0-9][a-z0-9-]{0,62}$. Derived from name when omitted.
Example: "staging"

Responses

Created

Body

application/json

idstringrequired
namestringrequired
objectstringrequired
Example: "project"
org_idstringrequired
rolestringrequired
Example: "owner"
slugstringrequired

Body

{
  "name": "Staging",
  "slug": "staging"
}

Request Sample: Shell / cURL

curl --request POST \
  --url https://api.workspaces.build/v1/projects \
  --header 'Accept: application/json, application/problem+json' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Staging",
  "slug": "staging"
}'

Response Example · 201

{
  "id": "string",
  "name": "string",
  "object": "project",
  "org_id": "string",
  "role": "owner",
  "slug": "string"
}