---
title: "List Files"
method: POST
path: "/sdk/v1.0/files/list"
tags: ["SDK"]
---

# List Files

`POST /sdk/v1.0/files/list`

List files in the project.

## Query parameters

- `project_id` string, uuid, nullable — The unique identifier of the project

## Request body

- ListFilesRequest
  - `folder` string[], nullable
  - `limit` integer
  - `offset` integer
  - `search` string, nullable
  - `sort_by` SortParameters
    - `sort_by` 'created_at' | 'updated_at' | 'name' | 'size' | 'last_accessed_at' | 'content_type'
    - `sort_direction` 'asc' | 'desc'

## Response `200`

Successful Response

- FileListResponse — Response model for listing files.
  - `files` FileInfoResponse[], required
    - `id` string, uuid, required — The unique identifier of the uploaded file
    - `name` string, required
    - `size` integer, required — File size in bytes
    - `content_type` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `path` string[], required — Folder path as array of tokens
    - `metadata` object
  - `total` integer, required
  - `has_more` boolean, required

## Other responses

- `422` — Validation Error

---

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