Files

Get file metadata

Changed on
get/files/{id}

Request

  • Base URL: https://api.varg.ai/v2
  • URL: https://api.varg.ai/v2/files/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Response

File metadata

idstring required
urlstring required
media_typestring required
size_bytesinteger required
hashstring nullable required
metadataobject nullable required
filenamestring nullable required
titlestring nullable required

AI-generated title

subtitlestring nullable required
thumbnail_urlstring nullable required
origin'upload' | 'generated' required
toolstring nullable required

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

created_bystring nullable required

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

expires_atstring date-time nullable required

null = never expires

created_atstring date-time nullable required

Example response

{
  "id": "file_abc123",
  "metadata": {
    "width": 1920,
    "height": 1080
  }
}

Changes