Skip to main content
GET
List uploaded files
Returns files uploaded to the current workspace only. Pagination and filtering via query parameters are OpenAI-compatible.

Authorizations

Authorization
string
header
required

API key in format: Bearer inf_***

Query Parameters

purpose
enum<string>

Filter by intended purpose. All SIX stored purposes are accepted — parsePurpose below validates against the full ApiFilePurpose enum, not the four OpenAI-compatible ones this parameter used to declare. pipeline_artifact and media_artifact are stamped on files our own pipeline and media-job workers produce, and a listing legitimately contains them, so filtering for them has always worked and was simply undocumented.

Available options:
assistants,
vision,
user_data,
batch,
pipeline_artifact,
media_artifact
limit
integer

Max items to return (default server-side)

Required range: 1 <= x <= 100
after
string

Pagination cursor — pass the previous response's last_id

Response

Workspace-scoped list of uploaded files.

object
string
Example:

"list"

data
object[]
has_more
boolean

Whether more pages exist after this one

Example:

false

last_id
string | null

Cursor for the next page (null if this page is the end)

Example:

"file_1hR9xTPZqK4mVLc2nJ7fY5wB"