---
title: "Return directory listing or file content"
method: GET
path: "/fs"
tags: ["fs"]
---

# Return directory listing or file content

`GET /fs`

Returns a list of files/directories if the requested path pointed to a directory or the content of the file otherwise

## Query parameters

- `download` boolean
- `recursive` boolean

## Response `200`

successful operation

- FsEntry[]
  - `name` string
  - `type` 'DIR' | 'FILE'
  - `parentFolder` string
  - `hasChildren` boolean
  - `children` FsEntry[]
  - `readable` boolean
  - `writeable` boolean
  - `mounted` boolean — true when this file/folder is inside a mounted folder
  - `trash` boolean — marks the trash folder
  - `inTrash` boolean — true when this entry is inside the trash folder
  - `hash` number — hash value for file content (CRC32)

## Other responses

- `403` — Not allowed
- `404` — Path not found

## Changes

> 28 revisions in range; 1 could not be searched.

- **2025-01-22** `aabc2933e4b6` — 2 info
  - added `#/components/schemas/DirContent` to the response body `allOf` list for the response status `200`
  - removed `#/components/schemas/DirContent` from the response body `oneOf` list for the response status `200`
- **2020-04-14** `6858c68bfb26` — 2 warning, 4 info
  - added the new `DIR` enum value to the `oneOf[#/components/schemas/DirContent]/items/type` response property for the response status `200`
  - added the new `FILE` enum value to the `oneOf[#/components/schemas/DirContent]/items/type` response property for the response status `200`
  - added the optional property `oneOf[#/components/schemas/DirContent]/items/children` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/DirContent]/items/inTrash` to the response with the `200` status
  - …2 more
- **2019-03-28** `d3297f16eb4f` — 1 info
  - added the new optional `query` request parameter `recursive`
- **2019-03-26** `6362d53efd2c` — 1 info
  - added the optional property `oneOf[#/components/schemas/DirContent]/items/trash` to the response with the `200` status
- **2019-03-24** `ea7ef104f5a8` — 1 info
  - added the new optional `query` request parameter `download`

[Full history](https://skmtc.dev/cometvisu/apis/cometvisu-manager-backend/changes/fs/get.md)

---

[API](https://skmtc.dev/cometvisu/apis/cometvisu-manager-backend.md) · [All operations](https://skmtc.dev/cometvisu/apis/cometvisu-manager-backend/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cometvisu/cometvisu-manager-backend/revisions/d5cd7c188244/schema)