Skip to main content
GET
List Directory

Overview

Returns the immediate children of a workspace directory. Pass an empty path (or omit it) to list the workspace root. The listing is not recursive — use GET /fs/zip to get the full tree as an archive.

Path Parameters

string
required
Browser session ID (UUID).

Query Parameters

string
Workspace-relative directory path. Empty or omitted lists the workspace root.

Example Request

Response

Success Response (200)

string
The listed workspace-relative directory path.
array
Entries in the directory. Each entry contains:
  • name (string) — basename of the entry.
  • path (string) — workspace-relative path of the entry.
  • type (string) — one of file, dir, symlink, other.
  • size (integer) — size in bytes (0 for directories).
  • mode (integer) — Unix mode.
  • mtime (string) — last modified timestamp (ISO 8601).
Example Response:

Error Responses