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
API Keys
Builds
Auth
Organizations
Runs
Secrets
Sessions
List this project's sessions
GET
Boot a tier
POST
Stop a session
DELETE
Get one session
GET
Change a session's max_lifetime_s, labels or metadata
PATCH
What the session reached and was refused
GET
Usage
Meta
Schemas
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
What the session reached and was refused
GET
/v1/sessions/{id}/network
Request
Path Parameters
id
string
required
Responses
200
default
OK
Body
application/json
