---
title: "Process Files List"
method: GET
path: "/api/processes/{process_id}/files/list"
---

# Process Files List

`GET /api/processes/{process_id}/files/list`

One directory of the process's workspace, relative to its root.

`Cache-Control: no-store`: this GET has no explicit caching headers
otherwise, and a directory listing changes any time the campaign writes a
new file — a browser that opportunistically cached one response (no
validator needed to do so; absence of Cache-Control is not the same as
"don't cache") kept serving it back verbatim on every later visit to this
same conversation, across ordinary reloads, showing a workspace frozen at
whatever it looked like the first time this exact URL was fetched.

## Path parameters

- `process_id` string, required

## Query parameters

- `path` string

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/omicos/apis/omicos-server.md) · [All operations](https://skmtc.dev/omicos/apis/omicos-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omicos/omicos-server/revisions/a00b94573ffe/schema)