API Reference

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Files

Upload File

FileCreateResponse Files.Create(FileCreateParamsparameters, CancellationTokencancellationToken = default)

POST/api/v1/beta/files

Query Files

Deprecated

FileQueryResponse Files.Query(FileQueryParams?parameters, CancellationTokencancellationToken = default)

POST/api/v1/beta/files/query

List Files

FileListPageResponse Files.List(FileListParams?parameters, CancellationTokencancellationToken = default)

GET/api/v1/beta/files

Delete File

Files.Delete(FileDeleteParamsparameters, CancellationTokencancellationToken = default)

DELETE/api/v1/beta/files/{file_id}

Read File Content

PresignedUrl Files.Get(FileGetParamsparameters, CancellationTokencancellationToken = default)

GET/api/v1/beta/files/{file_id}/content

ModelsExpand Collapse

class File:

Schema for a file.

required string ID

Unique identifier

formatuuid

required string Name

required string ProjectID

The ID of the project that the file belongs to

formatuuid

DateTimeOffset? CreatedAt

Creation datetime

formatdate-time

string? DataSourceID

The ID of the data source that the file belongs to

formatuuid

DateTimeOffset? ExpiresAt

The expiration date for the file. Files past this date can be deleted.

formatdate-time

string? ExternalFileID

The ID of the file in the external system

Long? FileSize

Size of the file in bytes

minimum0

string? FileType

File type (e.g. pdf, docx, etc.)

maxLength3000

minLength1

DateTimeOffset? LastModifiedAt

The last modified time of the file

formatdate-time

IReadOnlyDictionary<string, PermissionInfo?>? PermissionInfo

Permission information for the file

One of the following:

IReadOnlyDictionary<string, JsonElement>

IReadOnlyList<JsonElement>

string

Double

Boolean

string? Purpose

The intended purpose of the file (e.g., ‘user_data’, ‘parse’, ‘extract’, ‘split’, ‘classify’)

IReadOnlyDictionary<string, ResourceInfo?>? ResourceInfo

Resource information for the file

One of the following:

IReadOnlyDictionary<string, JsonElement>

IReadOnlyList<JsonElement>

string

Double

Boolean

DateTimeOffset? UpdatedAt

Update datetime

formatdate-time

class PresignedUrl:

Schema for a presigned URL.

required DateTimeOffset ExpiresAt

The time at which the presigned URL expires

formatdate-time

required string Url

A presigned URL for IO operations against a private file

formaturi

minLength1

IReadOnlyDictionary<string, string>? FormFields

Form fields for a presigned POST request