Import a file by URL
Files
Import a file by URL
Register a file from a URL. varg-hosted URLs (*.varg.ai) are
registered without re-uploading; external URLs are streamed to varg
storage. SSRF-protected (private IPs and localhost are rejected).
POST
Import a file by URL
Authorizations
varg API key (varg_...). Get one at app.varg.ai
or run bunx vargai login. App sessions may alternatively send a
Supabase JWT.
Body
application/json
Explicit provenance (defaults to generated for varg URLs, upload for external)
Available options:
upload, generated sha256 of the bytes for dedup (sha256:<hex> or bare hex)
Client-measured metadata (width, height, duration_ms, ...)