---
title: "Workspace List Files"
method: GET
path: "/api/v1/workspace/files"
tags: ["grep-public-api"]
---

# Workspace List Files

`GET /api/v1/workspace/files`

## Request

- Base URL: `https://api.grep.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.grep.ai/api/v1/workspace/files`
- Auth: none declared

List files in a workspace directory.

Returns: { "files": [{ "path": "...", "size": N, ... }], "path": "..." }

## Query parameters

- `path` string: Subdirectory path to list (e.g. 'projects/acme')

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/grep/apis/grep-api.md) - [All operations](https://skmtc.dev/grep/apis/grep-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grep/apis/grep-api/revisions/3719dd7f43ec?raw)