Workspaces

Workspaces are isolated environments for agent execution. Each workspace has its own file storage, browser sessions, and memory context.

Creating a Workspace

POST /workspaces
{"name": "Q3 Marketing Research"}

Workspace Contents

Each workspace contains:

Files — Code, documents, data files created by agents
Deliverables — Final outputs ready for download or deploy
Browser Sessions — Persistent cookies/localStorage for web automation
Memory — Session-level context that persists across tasks in this workspace

File Management

List Files

GET /workspaces/{workspace_id}/files

Upload / Download

GET /workspaces/{workspace_id}/files/{filename}/download
POST /workspaces/{workspace_id}/files (multipart upload)

Delete

DELETE /workspaces/{workspace_id}/files/{filename}

Deliverables

Agent outputs that are marked as “ready” become deliverables:

GET /workspaces/{workspace_id}/deliverables
GET /workspaces/{workspace_id}/deliverables/{id}/download

Multi-Workspace

You can have multiple workspaces for different projects. Switch between them in the War Room workspace selector. Agents inherit the workspace context when assigned to a task within that workspace.

Storage

Files are stored in S3/R2 with per-user encryption. Storage limits depend on your plan tier:

Tier	Storage
Free	100 MB
Starter	1 GB
Pro	5 GB
Max	25 GB
Team	50 GB
Business	100 GB
Enterprise	Unlimited