---
title: "Get Filesystem"
method: GET
path: "/filesystems/{filesystem_id}"
tags: ["Filesystems"]
---

# Get Filesystem

`GET /filesystems/{filesystem_id}`

Get filesystem details by ID.

## Path parameters

- `filesystem_id` string, required

## Response `200`

Successful Response

- FilesystemResponse — Response model for filesystem operations.
  - `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/versions/f24a474dc415/schema)