CLcloudglue
Files

Sync a public URL into a file

Changed on

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/{id}/sync.

post/files/sync

Request

  • Base URL
    https://api.cloudglue.dev/v1
  • Auth
    HTTP bearer

Request body

urlstring required

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>.

metadataobject

Optional metadata to associate with the file. Ignored if the URL was already synced (the existing file is returned unchanged).

enable_segment_thumbnailsboolean

Whether to generate per-segment thumbnails for the file. Defaults to true, matching file upload.

Example request

{
  "url": "https://example.com/video.mp4"
}

Response

The synced file

idstring required

Unique identifier for the file

status'pending' | 'processing' | 'completed' | 'failed' | 'not_applicable' required

Processing status of the file

bytesinteger nullable

Size of the file in bytes, null if not available

created_atinteger

Unix timestamp in milliseconds when the file was created

filenamestring

Original filename

uristring required

Cloudglue URI for the file, to be used in other API calls

metadataobject nullable

User-provided metadata about the file, null if none provided

media_type'video' | 'audio' | 'image'

Type of media file (video, audio, or image). Images are processed at the file level only (no segmentation).

thumbnail_urlstring

URL of the thumbnail for the file

source'video' | 'youtube' | 's3' | 'dropbox' | 'http' | 'upload' | 'google-drive' | 'zoom' | 'gong' | 'recall' | 'gcs' | 'grain' | 'loom' | 'iconik'

Source of the file

Changes

  • 23d3f240819fRevision changes
    • info

      removed the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • c02e52ec2e28Revision changes
    • breaking

      added to the //// response property oneOf list for the response status

    • warning

      added the new iconik enum value to the response property for the response status

    • info

      added iconik discriminator mapping keys to the //// response property for the response status