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

# Lists the files of the workspace

`GET /lambdas/{privateKey}/files`

## Request

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

## Path parameters

- `privateKey` string, required

## Response `200`

The files and folders of the workspace

- 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. A key that never existed and the key of a deleted lambda are answered alike.

---

[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)