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 takesfile_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 iscustom_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