---
title: "List Filesystems"
method: GET
path: "/filesystems"
tags: ["Filesystems"]
---

# List Filesystems

`GET /filesystems`

List all filesystems accessible to the current user.

## Query parameters

- `project_id` string, nullable — Optional project filter. When provided, requires read access to the project and returns only filesystems in that project.

## Response `200`

Successful Response

- FilesystemResponse[]
  - `archive_checksum` string, nullable — SHA256 checksum of the archive for detecting changes.
  - `archive_path` string, nullable — GCS path for the filesystem's archive.
  - `archive_size_bytes` integer, nullable — Size of the archive in bytes after last sync.
  - `created_at` string, date-time, nullable — The timestamp when the filesystem was created.
  - `id` string, required — The unique identifier of the filesystem.
  - `last_synced_at` string, date-time, nullable — Timestamp of the last successful sync operation.
  - `name` string, nullable — Optional human-readable name (unique per namespace).
  - `namespace_id` string, required — The namespace this filesystem belongs to.
  - `project_id` string, nullable — The project this filesystem belongs to (optional).
  - `status` 'CREATING' | 'READY' | 'SYNCING_UP' | 'SYNCING_DOWN' | 'FAILED', required — Filesystem lifecycle status states.
  - `updated_at` string, date-time, nullable — The timestamp when the filesystem was last updated.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/terminaluse/apis/sb0-api.md) · [All operations](https://skmtc.net/terminaluse/apis/sb0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminaluse/sb0-api/revisions/f24a474dc415/schema)