---
title: "Lists the files of a feature's workspace"
method: GET
path: "/lambdas/{privateKey}/features/{feature}/workspace"
tags: ["Workspace"]
---

# Lists the files of a feature's workspace

`GET /lambdas/{privateKey}/features/{feature}/workspace`

## Request

- Base URL: `https://genhttp.dev/api/v1`
- URL: `https://genhttp.dev/api/v1/lambdas/{privateKey}/features/{feature}/workspace`
- Auth: none declared

What the feature's preview reads and writes. The lambda's own workspace is not touched by it.

## Path parameters

- `privateKey` string, required
- `feature` string, required

## Response `200`

The files and folders of the feature's copy

- WorkspaceListing: What a workspace holds, and how much room it has left.
  - `Files` WorkspaceEntry[]: Every file, in every folder
    - `Path` string: Its path within the workspace, with forward slashes: `logs/today.txt`
    - `Size` integer: How many bytes it holds
    - `Modified` string, date-time: When it was last written
  - `Folders` string[]: Every folder, by its path - listed apart, since a folder may be empty
  - `UsedBytes` integer: The room the files and folders take, counted in blocks of 4 KB as the allowance is
  - `QuotaBytes` integer: The room the workspace may take: the data allowance of the lambda's tier, less what its database takes
  - `Enabled` boolean: Whether the workspace is switched on; while it is off, it holds nothing and nothing can be written

## Other responses

- `204`: A response containing no body
- `404`: No lambda has this editor key, or the lambda has no feature with this key: it never existed, or it was merged or deleted.

---

[API](https://skmtc.dev/genhttp/apis/genhttp-lambda-api.md) · [All operations](https://skmtc.dev/genhttp/apis/genhttp-lambda-api/llms.txt) · [OpenAPI document](https://skmtc.dev/genhttp/apis/genhttp-lambda-api/revisions/8b36699e03df?raw)