v42

latestOpenAPI 3.0.3raw.githubusercontent.com2026-07-2129120150.2 KB
File API

List files

Retrieve a paginated list of files with optional filtering by status, graph association, and file type.

get/v1/files

Query parameters

beforestring

The ID of the first object in the previous page. This parameter instructs the API to return the previous page of results.

afterstring

The ID of the last object in the previous page. This parameter instructs the API to return the next page of results.

limitinteger

Specifies the maximum number of objects returned in a page. The default value is 50. The minimum value is 1, and the maximum value is 100.

order'asc' | 'desc'

Specifies the order of the results. Valid values are asc for ascending and desc for descending.

graph_idstring uuid

The unique identifier of the graph to which the files belong.

status'in_progress' | 'completed' | 'failed'

Specifies the status of the files to retrieve. Valid values are in_progress, completed or failed.

file_typesstring

The extensions of the files to retrieve. Separate multiple extensions with a comma. For example: pdf,jpg,docx.

Response

has_moreboolean required

Indicates if there are more files available beyond the current page.

first_idstring

The ID of the first file in the current response.

last_idstring

The ID of the last file in the current response.