---
title: "List a directory"
method: GET
path: "/v1/sessions/{id}/files/list"
---

# List a directory

`GET /v1/sessions/{id}/files/list`

## Request

- Base URL: `https://assemble-vms-api.fly.dev`
- URL: `https://assemble-vms-api.fly.dev/v1/sessions/{id}/files/list`
- Auth: HTTP bearer

List up to 1,000 direct entries. A larger directory returns an error; this endpoint does not paginate directory entries.

## Query parameters

- `path` string

## Response `200`

Directory entries.

- object
  - `items` FileEntry[], required
    - `name` string, required
    - `type` 'file' | 'directory' | 'symlink' | 'other', required
    - `size` integer, required

## Other responses

- `default`: Structured API error. HTTP 400 invalid request, 401 authentication, 404 missing resource, 409 conflict, 413 size limit, 429 quota, or 503 unavailable.

---

[API](https://skmtc.dev/assemble/apis/assemble-vms-api.md) - [All operations](https://skmtc.dev/assemble/apis/assemble-vms-api/llms.txt) - [OpenAPI document](https://skmtc.dev/assemble/apis/assemble-vms-api/revisions/93f55a2e3de3?raw)