Skip to main content
GET
List files

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

workspace
string

Folder id or slug, or unfiled for files in no folder. When set, all other filters are ignored.

tool
string
model
string
q
string

Search in prompts/titles

kind
enum<string>

Media type (image, video, audio) or origin (upload, generated). origin is accepted as an alias.

Available options:
image,
video,
audio,
upload,
generated
limit
integer
default:50
Required range: 1 <= x <= 100
cursor
integer
default:0
Required range: x >= 0
from
string<date-time>
to
string<date-time>

Response

File list

data
object[]
required
nextCursor
integer | null
required

Offset to pass as cursor for the next page; null on the last page