Skip to main content
GET
List files with lineage

Authorizations

Authorization
string
header
required

varg API key (varg_...). Get one at app.varg.ai or run bunx vargai login. App sessions may alternatively send a Supabase JWT.

Query Parameters

kind
enum<string>[]

Media kind (image, video, audio) and/or origin (upload, generated). Unknown values are ignored.

Available options:
image,
video,
audio,
upload,
generated
tool
enum<string>[]

Restrict to files produced by these tools. Unknown values are ignored.

Available options:
image,
video,
speech,
music,
render,
transcription,
ffmpeg

Matches the prompt, text or code of the job that produced the file.

workspace
string

Folder id or slug, or unfiled for files in no folder.

favorites
boolean

When true, only files the caller has favorited.

created_by
string<uuid>

Only files created by this user id.

creator_api_key_id
string<uuid>

Only files created through this API key id.

from
string<date-time>

Earliest creation time (ISO 8601).

to
string<date-time>

Latest creation time (ISO 8601).

limit
integer
default:24
Required range: 1 <= x <= 100
cursor
integer
default:0

Offset returned as nextCursor by the previous page.

Required range: x >= 0

Response

Page of files

data
object[]
required
nextCursor
integer | null
required