API Reference

Files

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Query Files

Deprecated

client.files.query(FileQueryParams { organization_id, project_id, filter, 3 more } params, RequestOptionsoptions?): FileQueryResponse { items, next_page_token, total_size }

POST/api/v1/beta/files/query

Query files with filtering and pagination. Deprecated: use GET /files.

ParametersExpand Collapse

params: FileQueryParams { organization_id, project_id, filter, 3 more }

organization_id?: string | null

Query param

formatuuid

project_id?: string | null

Query param

formatuuid

filter?: Filter | null

Body param: Filter parameters for file queries.

data_source_id?: string | null

Filter by data source ID

formatuuid

external_file_id?: string | null

Filter by external file ID

file_ids?: Array<string> | null

Filter by specific file IDs

file_name?: string | null

Filter by file name

only_manually_uploaded?: boolean | null

Filter only manually uploaded files (data_source_id is null)

project_id?: string | null

Filter by project ID

formatuuid

order_by?: string | null

Body param: A comma-separated list of fields to order by, sorted in ascending order. Use ‘field_name desc’ to specify descending order.

page_size?: number | null

Body param: The maximum number of items to return. The service may return fewer than this value. If unspecified, a default page size will be used. The maximum value is typically 1000; values above this will be coerced to the maximum.

page_token?: string | null

Body param: A page token, received from a previous list call. Provide this to retrieve the subsequent page.

ReturnsExpand Collapse

FileQueryResponse { items, next_page_token, total_size }

Paginated list of files.

items: Array<Item>

The list of items.

id: string

Unique file identifier

name: string

File name including extension

maxLength3000

minLength1

project_id: string

Project this file belongs to

formatuuid

download_url?: PresignedURL { expires_at, url, form_fields } | null

Schema for a presigned URL.

expires_at: string

The time at which the presigned URL expires

formatdate-time

url: string

A presigned URL for IO operations against a private file

minLength1

formaturi

form_fields?: Record<string, string> | null

Form fields for a presigned POST request

expires_at?: string | null

When the file expires and may be automatically removed. Null means no expiration.

formatdate-time

external_file_id?: string | null

Optional ID for correlating with an external system

file_type?: string | null

File extension (pdf, docx, png, etc.)

maxLength3000

minLength1

last_modified_at?: string | null

When the file was last modified (ISO 8601)

formatdate-time

purpose?: string | null

How the file will be used: user_data, parse, extract, classify, split, sheet, or agent_app

next_page_token?: string | null

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

total_size?: number | null

The total number of items available. This is only populated when specifically requested. The value may be an estimate and can be used for display purposes only.

Query Files

TypeScript

HTTP

TypeScript

Python

Java

Go

CLI Tool

import LlamaCloud from '@llamaindex/llama-cloud';

const client = new LlamaCloud({
  apiKey: process.env['LLAMA_CLOUD_API_KEY'], // This is the default and can be omitted
});

const response = await client.files.query();

console.log(response.items);

200 example

{
  "items": [
    {
      "id": "dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "name": "invoice.pdf",
      "project_id": "123e4567-e89b-12d3-a456-426614174000",
      "download_url": {
        "expires_at": "2019-12-27T18:11:19.117Z",
        "url": "https://example.com",
        "form_fields": {
          "foo": "string"
        }
      },
      "expires_at": "2019-12-27T18:11:19.117Z",
      "external_file_id": "ext-12345",
      "file_type": "pdf",
      "last_modified_at": "2019-12-27T18:11:19.117Z",
      "purpose": "parse"
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}

Returns Examples

200 example

{
  "items": [
    {
      "id": "dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "name": "invoice.pdf",
      "project_id": "123e4567-e89b-12d3-a456-426614174000",
      "download_url": {
        "expires_at": "2019-12-27T18:11:19.117Z",
        "url": "https://example.com",
        "form_fields": {
          "foo": "string"
        }
      },
      "expires_at": "2019-12-27T18:11:19.117Z",
      "external_file_id": "ext-12345",
      "file_type": "pdf",
      "last_modified_at": "2019-12-27T18:11:19.117Z",
      "purpose": "parse"
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}