Skip to main content
GET
/
filesystems
List Filesystems
curl --request GET \
  --url https://api.example.com/filesystems
[
  {
    "id": "<string>",
    "namespace_id": "<string>",
    "status": "CREATING",
    "archive_checksum": "<string>",
    "archive_path": "<string>",
    "archive_size_bytes": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "last_synced_at": "2023-11-07T05:31:56Z",
    "name": "<string>",
    "project_id": "<string>",
    "updated_at": "2023-11-07T05:31:56Z"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.terminaluse.com/llms.txt

Use this file to discover all available pages before exploring further.

​
CLI Usage

CLI
# List all filesystems (across all projects)
tu fs ls

# List filesystems for a specific project
tu fs ls --project-id proj-123

# JSON output
tu fs ls -j

Query Parameters

​
project_id
string | null

Optional project filter. When provided, requires read access to the project and returns only filesystems in that project.

Response

Successful Response

​
id
string
required

The unique identifier of the filesystem.

​
namespace_id
string
required

The namespace this filesystem belongs to.

​
status
enum<string>
required

The current status of the filesystem.

Available options:
CREATING,
READY,
SYNCING_UP,
SYNCING_DOWN,
FAILED
​
archive_checksum
string | null

SHA256 checksum of the archive for detecting changes.

​
archive_path
string | null

GCS path for the filesystem's archive.

​
archive_size_bytes
integer | null

Size of the archive in bytes after last sync.

​
created_at
string<date-time> | null

The timestamp when the filesystem was created.

​
last_synced_at
string<date-time> | null

Timestamp of the last successful sync operation.

​
name
string | null

Optional human-readable name (unique per namespace).

​
project_id
string | null

The project this filesystem belongs to (optional).

​
updated_at
string<date-time> | null

The timestamp when the filesystem was last updated.