---
title: "List Project Files"
method: GET
path: "/v1/projects/{project_id}/files"
tags: ["v1", "protected", "projects"]
---

# List Project Files

`GET /v1/projects/{project_id}/files`

List files under the project's prefix.

## Path parameters

- `project_id` string, uuid, required

## Response `200`

Successful Response

- ProjectFileListResponse
  - `files` ProjectFileInfo[], required
    - `last_modified` string, nullable
    - `path` string, required
    - `size` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-29** `e1a530c0a2d5` — 4 breaking
  - the response property `files/items/last_modified` became optional for the status `200`
  - response property `files/items/last_modified` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - removed the required property `files/items/key` from the response with the `200` status
  - removed the required property `prefix` from the response with the `200` status
- **2026-03-30** `e9c153221160` — 4 info
  - the response property `files/items/last_modified` became required for the status `200`
  - response property `files/items/last_modified` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - added the required property `files/items/key` to the response with the `200` status
  - added the required property `prefix` to the response with the `200` status

[Change history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/projects/:project_id/files/get.md)

---

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