Skip to main content
GET
List Files

Authorizations

Authorization
string
header
required

Use the format: Key modelrunner_key

Query Parameters

sources
enum<string>[]

Repeat to union buckets. upload — files you uploaded; output — files a model produced for you; input — your uploads that a request consumed. external rows are excluded unless you ask for them explicitly.

Available options:
upload,
output,
input,
external
tagIds
string<uuid>[]

Repeat for multiple tags.

tagRule
enum<string>
default:any

How multiple tagIds combine.

Available options:
any,
all
favoritesOnly
boolean
q
string

Substring match over the storage key and URL.

mimeTypePrefix
string

e.g. image/, video/, audio/.

requestId
string

Only files linked to this request.

role
enum<string>

Only files linked in this role.

Available options:
input,
output,
thumbnail
source
enum<string>

Filter on the stored source column. Prefer sources, which matches the buckets in File Facets.

Available options:
upload,
request_output,
external
order
enum<string>
default:newest
Available options:
newest,
oldest
page
integer
default:1
limit
integer
default:20
Required range: x <= 100

Response

One page of files.

items
object[]
pagination
object