---
title: "List Workspace Files"
method: GET
path: "/api/conversations/{conversation_id}/list-files"
---

# List Workspace Files

`GET /api/conversations/{conversation_id}/list-files`

List workspace files visible to the conversation runtime. Applies .gitignore and internal ignore rules.

## Path parameters

- `conversation_id` string, required

## Query parameters

- `path` string, nullable

## Response `200`

Successful Response

- string[]

## Other responses

- `404` — Runtime not initialized
- `422` — Validation Error
- `500` — Error listing or filtering files

---

[API](https://skmtc.dev/all-hands/apis/openhands.md) · [All operations](https://skmtc.dev/all-hands/apis/openhands/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/all-hands/openhands/revisions/4daa2bb4dbf1/schema)