Skip to main content
GET
Get File by URL

Authorizations

Authorization
string
header
required

Use the format: Key modelrunner_key

Query Parameters

url
string
required

The canonical file_url, matched exactly.

Response

The file and its request linkages.

A file plus its request linkages.

id
string<uuid>
url
string

Canonical public URL on the media domain. Pass this to any model input that accepts a file.

thumbnailUrl
string | null

Lightweight generated preview (.webp image / .webm motion preview) for request outputs. Null for uploads, audio, and older rows — fall back to url.

userId
string | null
mimeType
string | null
sizeBytes
integer | null
storageKey
string | null
source
enum<string>

How the row was created: upload (you uploaded it), request_output (a model produced it), external (a URL recorded from elsewhere).

Available options:
upload,
request_output,
external
createdAt
string<date-time>
isFavorited
boolean

Whether you have favorited this file.

tags
object[]

Tags you have applied to this file.

requests
object[]

Every request this file is linked to, as input or output.