Skip to main content
GET
Get a file 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.

Path Parameters

id
string
required

Response

The file

id
string
source
enum<string>

gateway for generated files, attachment for uploads.

Available options:
attachment,
gateway
url
string
filename
string | null
title
string | null
subtitle
string | null
media_type
string | null
size
integer | null
created_at
string<date-time>
hash
string | null
thumbnail_url
string | null
origin
enum<string>
Available options:
upload,
generated
created_by
string<uuid> | null
created_by_profile
object | null
creator_type
enum<string> | null
Available options:
user,
api_key,
system,
null
created_by_api_key
object | null

The API key the file was created through. Only set when creator_type is api_key.

metadata
object | null
lineage
object | null

The job that produced a file. Detail responses carry extra fields (provider, breakdown, created_at, file).

is_favorite
boolean