Skip to main content
This page covers the app-side integration path:
  • create a filesystem
  • create a task
  • send events
  • inspect messages and files

Client Setup

Create A Filesystem

Filesystems belong to projects. Projects are the permission boundary; filesystems are the storage.

Put Files Into It

There are three different file flows: See Workspaces and Filesystems for the full breakdown.

Create A Task

Attach either an existing filesystem or a project:
If you pass project_id instead of filesystem_id, Terminal Use creates a filesystem for the task automatically.

Send Events

Inspect Files

File Metadata And Content

Single-File Download

For whole-filesystem transfers, use tu fs push, tu fs pull, getUploadUrl, or getDownloadUrl instead.