---
title: "List files attached to a project"
method: GET
path: "/api/v2/programmatic/projects/{projectId}/files"
tags: ["Projects"]
---

# List files attached to a project

`GET /api/v2/programmatic/projects/{projectId}/files`

Files are derived from project reference objects.

## Path parameters

- `projectId` string, required

## Query parameters

- `branch` string

## Response `200`

Project files.

- ListFilesEnvelope
  - `success` boolean, required
  - `data` ListFilesResponse, required
    - `files` FileInfo[], required
      - `id` string, required
      - `name` string, required
      - `parent` string, required
      - `fileType` string, nullable
      - `filename` string, nullable
    - `count` integer, required

## Other responses

- `401` — Missing, invalid, expired, or inactive API key.
- `403` — Caller is authenticated but not authorized.
- `404` — Project does not exist or is hidden from the caller.
- `429` — API key request rate exceeded.
- `500` — Unexpected server error.
- `503` — Project acquisition unavailable. Common error codes include `PROJECT_NOT_READY`, `SERVICE_UNAVAILABLE`, and `SERVER_NOT_AVAILABLE`.

---

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