Skip to main content

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:
TierStorage
Free100 MB
Pro5 GB
Power25 GB
Business100 GB
EnterpriseUnlimited