Skip to main content

Overview

Every agent conversation gets an isolated sandbox file system. This page covers reading and writing those files from your own code.
Workspaces covers the other side of the same feature: the write, read, edit, grep and delete tools the agent uses on those files while it works. This page is the SDK methods you call.

Workspaces

List workspaces

Create a workspace

Delete a workspace

Files

List files

Read a file

Create a file

file_path is the path inside the workspace, so nested directories are created by writing to them.

Update a file

Note this takes file_uuid, not the path — the path can change under you, the uuid cannot.

Rename or move a file

Delete a file

Download the whole workspace

Returns the workspace as a ZIP.

Publishing

Suggest a subdomain

Publish

Unpublish

Custom Domains

Attach a domain

The parameter is custom_domain. A key named domain is not one this method accepts, and because requests are built from named parameters it would be dropped — producing a request with no domain in it at all.

Check verification status

Attaching a domain returns the DNS records to create. Poll this until it verifies.

Read the current domain

Remove the domain

Next Steps

Workspaces

The file tools the agent itself uses

API Reference

Every method in one place