Skip to main content
GET
Get file metadata

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

File metadata

id
string
required
Example:

"file_abc123"

url
string
required
media_type
string
required
size_bytes
integer
required
hash
string | null
required
metadata
object | null
required
Example:
filename
string | null
required
title
string | null
required

AI-generated title

subtitle
string | null
required
thumbnail_url
string | null
required
origin
enum<string>
required
Available options:
upload,
generated
tool
string | null
required

The tool of the job that produced this file (via lineage)

created_by
string | null
required

User id of the person who created the file (null for service keys and system)

expires_at
string<date-time> | null
required

null = never expires

created_at
string<date-time> | null
required