Sync File from URL
Materialize a publicly accessible URL into a Cloudglue file without a data connector or a collection. Accepts direct http(s) video/audio file URLs (e.g. .mp4), public Dropbox share links, TikTok video URLs, and Loom share URLs. Idempotent: syncing the same URL returns the existing file. YouTube URLs are not supported here — add them to a collection via the add-media endpoint instead. Connector-native URIs (e.g. s3://, gs://, gdrive://, Zoom/Gong/Recall/Grain links) require the matching data connector — use POST /data-connectors//sync.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Publicly accessible URL to sync. Accepted forms — direct http(s) file URL: https://example.com/video.mp4 · Dropbox share link: https://www.dropbox.com/scl/fi/... or https://www.dropbox.com/s/... · TikTok: https://www.tiktok.com/@user/video/<id> (and vm.tiktok.com/vt.tiktok.com short links) · Loom: https://www.loom.com/share/<id>.
"https://example.com/video.mp4"
Optional metadata to associate with the file. Ignored if the URL was already synced (the existing file is returned unchanged).
Whether to generate per-segment thumbnails for the file. Defaults to true, matching file upload.
Response
The synced file
Unique identifier for the file
Processing status of the file
pending, processing, completed, failed, not_applicable Cloudglue URI for the file, to be used in other API calls
Size of the file in bytes, null if not available
Unix timestamp in milliseconds when the file was created
Original filename
User-provided metadata about the file, null if none provided
Type of media file (video or audio)
video, audio Unified media information for both video and audio files
Information about the video content
URL of the thumbnail for the file
Source of the file
video, youtube, s3, dropbox, http, upload, google-drive, zoom, gong, recall, gcs, grain, loom Source provenance captured from the upstream connector at ingest time. Null when nothing was captured (older files, or a connector that does not yet populate it).