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

# List Files

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

## Request

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

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

## Changes

- **2026-10-14** `6e68f3c2611b`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/rebolt/apis/rebolt-api/changes/sdk/v1.0/files/list/post.md)

---

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