Skip to main content
GET
/
filesystems
/
{filesystem_id}
Get Filesystem
curl --request GET \
  --url https://api.example.com/filesystems/{filesystem_id}
{
  "id": "<string>",
  "namespace_id": "<string>",
  "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"
}

​
CLI Usage

CLI
tu fs get fs-uuid

# JSON output
tu fs get fs-uuid -j

Path Parameters

​
filesystem_id
string
required

Response

Successful Response

Response model for filesystem operations.

​
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.